IsValidAcl function (securitybaseapi.h)

Article
02/22/2024

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

Syntax

BOOL IsValidAcl(
  [in] PACL pAcl
);

Parameters

[in] 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

Requirement	Value
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