This topic has not yet been rated - Rate this topic

IsValidAcl function

Applies to: desktop apps only

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

Minimum supported server

Windows Server 2003

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

 

 

Send comments about this topic to Microsoft

Build date: 3/7/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ