VMS Help DCE_SECURITY, API Routines, sec_acl_get_error_info  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME
   sec_acl_get_error_info - 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
     SYS$COMMON:[DCE$LIBRARY]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

   sec_acl_invalid_handle
               The ACL handle specified by sec_acl_handle_t is invalid.

 RELATED INFORMATION

   Functions: sec_intro
              sec_acl_bind
              sec_acl_lookup