Previous section.

DCE 1.1: Authentication and Security Services
Copyright © 1997 The Open Group

NAME

sec_acl_get_manager_types-Obtain list of ACL manager types on a protected object.

SYNOPSIS

#include <dce/daclif.h>

void sec_acl_get_manager_types(
    sec_acl_handle_t prot_obj_handle,
    sec_acl_type_t acl_type,
    unsigned32 count_max,
    unsigned32 *count,
    unsigned32 *num_manager_types,
    uuid_t manager_types[],
    error_status_t *status);

PARAMETERS

Input

prot_obj_handle

Handle to a protected object.

acl_type

An ACL type of the protected object.

count_max

Maximum number of elements the calling client is prepared to receive in its manager_types[] array.

Output

count

Actual number of elements returned to the calling client in its manager_types[] array.

num_manager_types

Total number of ACL manager types, of ACL type acl_type, at the heads of chains (see sec_acl_get_printstring()), protecting the protected object.

manager_types[]

Array of size count, of ACL manager types managing ACLs of ACL type acl_type on the protected object.

status

Completion status. On successful completion, error_status_ok is returned. Otherwise, an error (!= error_status_ok) is returned.

DESCRIPTION

The sec_acl_get_manager_types() routine returns a list of distinct UUIDs of different ACL manager types managing ACLs of ACL type acl_type that are protecting the object identified by prot_obj_handle. In the case of a chain of ACL managers (each supporting <= 32 permission bits), only the first ACL manager in the chain is returned in this way, and the rest are returned by calls to sec_acl_get_printstring().

The sec_acl_get_manager_types() routine also returns, in num_manager_types, the total number of ACL manager types, of ACL type acl_type, at the heads of chains, protecting the protected object. An invocation of this routine is completely successful only if count = num_manager_types.

NOTES

Implementations layer this routine over the rdacl RPC interface operation rdacl_get_manager_types().

ERRORS

error_status_ok.

SEE ALSO

Functions: sec_acl_bind(), sec_acl_bind_to_addr(), sec_acl_get_printstring().

Protocols: rdacl_get_manager_types().

Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.

Contents Next section Index