PreviousNext

dce_acl_inq_acl_from_header(3sec)

Retrieves the UUID of an ACL from an item's header in a backing store

Synopsis

#include <dce/dce.h>
#include <dce/aclif.h>

void dce_acl_inq_acl_from_header(
dce_db_header_t db_header,
sec_acl_type_t
sec_acl_type,
uuid_t *
acl_uuid,
error_status_t *
status);

Parameters

Input

db_header
The backing store header containing the ACL object.

sec_acl_type
The type of ACL to be identified: sec_acl_type_object, sec_acl_type_default_object, or sec_acl_type_default_container.

Output

acl_uuid
A pointer to the UUID of the ACL object.

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_inq_acl_from_header( ) routine gets the UUID for an ACL object of the specified type from the specified backing store header.

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.

db_s_key_not_found
The specified key was not found in the backing store. (This error is passed through from dce_db_fetch( ).)

db_s_bad_index_type
The key's type is wrong, or else the backing store is not by name or by UUID. (This error is passed through from dce_db_fetch( ).)

sec_acl_invalid_type
The sec_acl_type parameter does not contain a valid type.

error_status_ok
The call was successful.

Related Information
Functions:

dce_acl_resolve_by_name(3sec)

dce_acl_resolve_by_uuid(3sec)