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

 NAME
   sec_acl_bind_to_addr - Returns a handle to an object identified by
                          its network address

 SYNOPSIS

   #include <dce/daclif.h>

   void sec_acl_bind_to_addr(
           unsigned char *site_addr,
           sec_acl_component_name_t component_name,
           sec_acl_handle_t *h,
           error_status_t *status);

 PARAMETERS

   Input

   site_addr
           An RPC string binding to the fully qualified network address of
           the target object.

   component_name
           The name of the target object. Subsequent ACL operations using
           the returned handle will affect the ACL of this 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_to_addr() routine returns a handle bound to the
   indicated object's ACL manager. This routine and the sec_acl_bind()
   routine are central to all the other sec_acl routines, each of which
   requires a handle to identify the ACL on which to operate.

   This routine differs from sec_acl_bind() in that it binds to the network
   address of the target object, rather than to a cell namespace entry.
   Therefore, unlike sec_acl_bind(), it is possible to pass
   sec_acl_bind_to_addr() a null string as a component name and to bind
   with a nonexistent name.  The purpose of this call is to eliminate the
   necessity of looking up an object's name.  To validate the name, use
   sec_acl_bind().

 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.

   sec_acl_unable_to_authenticate
               The call could not authenticate to the server that manages
               the target object's ACL.

   sec_acl_bind_error
               The call could not bind to the requested site.

   sec_acl_invalid_site_name
               The site_addr parameter is invalid.

   sec_acl_cant_allocate_memory
               Memory allocation failure.

   error_status_ok
               The call was successful.

 RELATED INFORMATION

   Functions: sec_intro