Export (0) Print
Expand All
Expand Minimize

IsValidAcl function

The IsValidAcl function validates an access control list (ACL).

Syntax


BOOL WINAPI IsValidAcl(
  _In_ PACL pAcl
);

Parameters

pAcl [in]

A pointer to an ACL structure validated by this function. This value must not be NULL.

Return value

If the ACL is valid, the function returns nonzero.

If the ACL is not valid, the function returns zero. There is no extended error information for this function; do not call GetLastError.

Remarks

This function checks the revision level of the ACL and verifies that the number of access control entries (ACEs) specified in the AceCount member of the ACL structure fits the space specified by the AclSize member of the ACL structure.

If pAcl is NULL, the application will fail with an access violation.

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
ACL
GetAclInformation
InitializeAcl

 

 

Community Additions

ADD
Show:
© 2015 Microsoft