FindFirstFreeAce function
The FindFirstFreeAce function retrieves a pointer to the first free byte in an access control list (ACL).
Syntax
BOOL WINAPI FindFirstFreeAce( _In_ PACL pAcl, _Out_ LPVOID *pAce );
Parameters
- pAcl [in]
-
A pointer to an ACL.
- pAce [out]
-
The address of a pointer to the first free position in the ACL created when the function returns. If the ACL is not valid, this parameter is NULL. If the ACL is full, this parameter points to the byte immediately following the ACL.
Return value
If the function succeeds, the function returns nonzero.
If the function fails, it returns zero. To get extended error information, call GetLastError.
Requirements
|
Minimum supported client |
Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
See also
Show: