NAME

dce_acl_inq_acl_from_header — Retrieves the UUID of an ACL from an item’s header in a backing store

Synopsis

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

   •sec_acl_type_default_container

Output

acl_uuidA pointer to the UUID of the ACL object. 

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