NAME

sec_acl_release-Free (local copy of) ACLs.

SYNOPSIS

#include <dce/daclif.h>

void sec_acl_release(
    sec_acl_handle_t prot_obj_handle,
    sec_acl_t *acl,
    error_status_t *status);

PARAMETERS

Input

prot_obj_handle

Handle to a protected object.

acl

ACL to be released.

Output

status

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

DESCRIPTION

The sec_acl_release() routine releases local copies of ACLs which had previously been obtained by sec_acl_lookup().

NOTES

This is a local memory management operation, and has no effect on the protected object to which prot_obj_handle is bound, or to its ACLs.

Note that sec_acl_lookup() returns a list of ACLs, while sec_acl_release() releases ACLs only one at a time. This allows applications to retain only those ACLs of interest to them, without tying up memory for ACLs it isn't interested in.

ERRORS

error_status_ok.

SEE ALSO

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