NAME

sec_acl_get_error_info — Returns error information from an ACL handle

Synopsis

error_status_t sec_acl_get_error_info(
sec_acl_handle_t h);

Parameters

Input

hA handle referring to the target ACL. The handle is bound to the ACL with the sec_acl_bind() routine, which also specifies the name of the object to which the target ACL belongs. 

Description

The sec_acl_get_error_info() routine returns error information from the specified ACL handle. 

During a call to a routine in the sec_acl application programming interface (API), error codes received from the RPC runtime or other APIs are saved in the ACL handle and a corresponding error code from the sec_acl set is passed back by the ACL API. The sec_acl_get_error_info() routine returns the last error code stored in the ACL handle for those clients who need to know exactly what went wrong. 

Files

/usr/include/dce/daclif.idl
The idl file from which dce/daclif.h was derived. 

Return Values

This routine returns a value of type error_status_t, indicating the cause of the last error issued by the RPC runtime. 

Errors

The following describes a partial list of errors that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

sec_acl_invalid_handle
The ACL handle specified by sec_acl_handle_t is invalid. 

Related Information

Functions: sec_acl_bind(3sec), sec_acl_lookup(3sec), sec_intro(3sec).