NAME

dce_acl_resolve_by_name — Finds an ACL’s UUID, given an object’s name

Synopsis

void dce_acl_resolve_by_name(
handle_t handle,
sec_acl_component_name_t component_name,
sec_acl_type_t sec_acl_type,
uuid_t ∗mgr_type,
boolean32 writing,
void ∗resolver_arg,
uuid_t ∗acl_uuid,
error_status_t ∗status);

Parameters

Input

handleA client binding handle passed into the server stub.  Use sec_acl_bind() to create this handle. 

component_name
A character string containing the name of the target object.

sec_acl_type
The type of ACL to be resolved:

   •sec_acl_type_object

   •sec_acl_type_default_object

   •sec_acl_type_default_container

mgr_typeA pointer to the UUID identifying the type of the ACL manager in question.  There may be more than one type of ACL manager protecting the object whose ACL is bound to the input handle.  Use this parameter to distinguish them. 

writingThis parameter is ignored in OSF’s implementation. 

resolver_arg
This argument is passed into dce_acl_register_object_type().  It should be a handle for a backing store indexed by name. 

Output

acl_uuidThe ACL UUID, as resolved by dce_acl_resolve_by_name(). 

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

Description

The dce_acl_resolve_by_name() routine finds an ACL’s UUID, given an object’s name, as provided in the component_name parameter.  The user does not call this function directly.  It is an instance of the kind of function provided to the resolver argument of dce_acl_register_object_type(). 

If dce_acl_resolve_by_name() and dce_acl_resolve_by_uuid() are inappropriate, the user of dce_acl_register_object_type() must provide some other resolver function. 

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. 

error_status_ok
The call was successful.

Related Information

Functions: dce_acl_register_object_type(3sec), dce_acl_resolve_by_uuid(3sec), dce_db_open(3dce),dce_db_header_fetch(3dce).