FindFirstFreeAce

  BOOL FindFirstFreeAce(pAcl, pAce)    
  PACL pAcl;    
  LPVOID *pAce;    

This routine retrieve a pointer to the first free byte in an ACL.

Parameters

pAcl

Supplies a pointer to the ACL to examine

pAce

Receives a pointer to the first free position in the ACL. If the ACL is ill-formed, pAce is NULL. If the ACL is full, pAce points to the byte immediately following the ACL.

Return Value

The return value is TRUE if the function was successful, or FALSE if an error occurred. Use the GetLastError function to obtain extended error information.