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

 NAME
   sec_acl_bind - Returns a handle for an object's ACL

 SYNOPSIS

   #include <dce/daclif.h>

   void sec_acl_bind(
           unsigned char *entry_name,
           boolean32 bind_to_entry,
           sec_acl_handle_t *h,
           error_status_t *status);

 PARAMETERS

   Input

   entry_name
         The name of the target object. Subsequent ACL operations using the
         returned handle will affect the ACL of this object.

   bind_to_entry
         Bind indicator, for use when entry_name identifies both an entry
         in the global namespace and an actual object.  A TRUE value binds
         the handle to the entry in the namespace, while FALSE binds the
         handle to the actual object.

   Output

   h     A pointer to the sec_acl_handle_t variable to receive the returned
         ACL handle.  The other sec_acl routines use this handle to refer
         to the ACL for the object specified with entry_name.

   status
         A pointer to the completion status.  On successful completion, the
         routine returns error_status_ok.  Otherwise, it returns an error.

 DESCRIPTION

   The sec_acl_bind() routine returns a handle bound to the indicated
   object's ACL.  This routine is central to all the other sec_acl
   routines, each of which requires this handle to identify the ACL on
   which to operate.

 NOTES

   If the specified name is both an actual object, and an entry in the
   global namespace, there are two ACLs associated with it.  For example,
   in addition to the ACL normally attached to file system objects, the
   root directory of a file system has an ACL corresponding to its entry
   in the global namespace. This controls access by outsiders to the entire
   file system, whereas the resident ACL for the root directory only
   controls access to the directory and, by inheritance, its subdirectories.
   The ambiguity must be resolved with the bind_to_entry parameter.

 FILES
     SYS$COMMON:[DCE$LIBRARY]DACLIF.IDL
               The idl file from which dce/daclif.h was derived.

 ERRORS

   sec_acl_object_not_found
               The requested object could not be found.

   sec_acl_no_acl_found
               There is no ACL associated with the specified object.

   error_status_ok
               The call was successful.

 RELATED INFORMATION

   Functions: sec_intro