NAME

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

Synopsis

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_addrAn 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

hA 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. 

statusA 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).