IsValidAcl function

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

Syntax

BOOL IsValidAcl(
  PACL pAcl
);

Parameters

pAcl

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 | UWP apps]
Minimum supported server Windows Server 2003 [desktop apps | UWP apps]
Target Platform Windows
Header securitybaseapi.h (include Windows.h)
Library Advapi32.lib
DLL Advapi32.dll

See Also

ACL

GetAclInformation

InitializeAcl

Low-level Access Control

Low-level Access Control Functions