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
);
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.
Windows NT: Requires version 3.1 or later.
Windows: Unsupported.
Windows CE: Unsupported.
Header: Declared in winbase.h.
Import Library: Use advapi32.lib.
Low-Level Access-Control Overview, Low-Level Access Control Functions, ACL, GetAce, GetAclInformation