Previous section.

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

NAME

sec_acl_lookup-Retrieve ("read") ACLs from a protected object, creating a copy locally on the client.

SYNOPSIS

#include <dce/daclif.h>

void sec_acl_lookup(
    sec_acl_handle_t prot_obj_handle,
    uuid_t *manager_type,
    sec_acl_type_t acl_type,
    sec_acl_list_t *acl_list,
    error_status_t *status);

PARAMETERS

Input

prot_obj_handle

Handle to a protected object.

manager_type

An ACL manager type UUID of the protected object.

acl_type

An ACL type of the protected object.

Output

acl_list

Copy of retrieved ACL.

status

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

DESCRIPTION

The sec_acl_lookup() routine loads into local memory a copy of the specified protected object's ACLs, managed by the specified ACL manager.

NOTES

The local memory containing the retrieved ACL is dynamically allocated (see sec_acl_release()).

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

ERRORS

error_status_ok, sec_acl_unknown_manager_type, sec_acl_cant_allocate_memory.

SEE ALSO

Functions: sec_acl_bind(), sec_acl_bind_to_addr(), sec_acl_get_manager_types(), sec_acl_get_manager_types_semantics(), sec_acl_release(), sec_acl_replace().

Protocols: rdacl_lookup().

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