PreviousNext

sec_acl_get_error_info(3sec)

Returns error information from an ACL handle

Synopsis

#include <dce/daclif.h>

error_status_t sec_acl_get_error_info(
sec_acl_handle_t
h);

Parameters

Input

h
A 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_intro(3sec)

sec_acl_bind(3sec)

sec_acl_lookup(3sec)