| ## sec_acl_bind_to_addr(3sec) 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 /usr/include/dce/daclif.idl The idl file from which dce/daclif.h was derived. 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_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(3sec) ##