Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

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

Winbase.h (include Windows.h)

Library

Advapi32.lib

DLL

Advapi32.dll

See also

Low-level Access Control
Low-level Access Control Functions
GetAce
GetAclInformation

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.