IsValidAcl

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

BOOL IsValidAcl(
  PACL pAcl   // access-control list
);

Parameters

pAcl

[in] Pointer to an ACL structure validated by this function. This must be a non-NULL value.

Return Values

If the ACL is valid, the return value is nonzero.

If the ACL is not valid, the return value is 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

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Header: Declared in Winbase.h; include Windows.h.
  Library: Use Advapi32.lib.

See Also

Low-Level Access-Control Overview, Low-Level Access Control Functions, ACL, GetAclInformation, InitializeAcl