FindFirstFreeAce
The FindFirstFreeAce
function retrieves a pointer to the first free byte in an access-control list
(ACL).
BOOL FindFirstFreeAce(
|
PACL pAcl, |
// pointer to
access-control list |
|
LPVOID *pAce |
// pointer to
pointer to first free byte |
|
); |
|
Parameters
pAcl
Points to an ACL structure.
pAce
Points to a
pointer to the first free position in the ACL created when the function
returns. If the ACL is invalid, this parameter is NULL. If the ACL is full,
this parameter points to the byte immediately following the ACL.
Return Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
See Also