dce_acl_resolve_by_name(3sec)
Finds an ACL's UUID, given an object's name
Synopsis
#include <dce/dce.h>
#include <dce/aclif.h>
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
handle
A 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, or sec_acl_type_default_container.
mgr_type
A 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.
writing
This 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_uuid
The ACL UUID, as resolved by dce_acl_resolve_by_name( ).
status
A 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)