sec_acl_bind_to_addr(3sec)

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)