GetAclInformation

	BOOL GetAclInformation(Acl, AclInformation, AclInformationLength, AclInformationClass)
	PACL Acl;
	LPVOID AclInformation;
	DWORD AclInformationLength;
	ACL_INFORMATION_CLASS AclInformationClass;

The GetAclInformation function retrieves information about an ACL. An ACL is a security access control list.

Parameters

Acl

Pointer to an existing ACL data structure. The function will retrieve information about this ACL.

The ACL data structure has the following form:

typedef struct _ACL { /* acl */

BYTE AclRevision;

BYTE Sbz1;

WORD AclSize;

WORD AceCount;

WORD Sbz2;

} ACL;

AclInformation

Pointer to a buffer that the function will fill with the information requested by the caller. The buffer must be aligned on at least a longword boundary. The actual structures put into the buffer depend on the information class requested. See the discussion of the AclInformationClass parameter below.

AclInformationLength

Specifies the size, in bytes, of the buffer pointed to by AclInformation.

AclInformationClass

Specifies the class of information requested. The following values have meaning:

Value

Meaning

AclRevisionInformation	The function will fill the buffer pointed to by AclInformation with an ACL_REVISION_INFORMATION data structure.
	The ACL_REVISION_INFORMATION data structure has the following form:
	typedef struct _ACL_REVISION_INFORMATION { DWORD AclRevision; } ACL_REVISION_INFORMATION;
AclSizeInformation	The function will fill the buffer pointed to by AclInformation with an ACL_SIZE_INFORMATION data structure.
	The ACL_SIZE_INFORMATION data structure has the following form:
	typedef struct _ACL_SIZE_INFORMATION { DWORD AceCount; DWORD AclBytesInUse; DWORD AclBytesFree; } ACL_SIZE_INFORMATION;

Return Value

The return value is TRUE if the function was successful, or FALSE if an error occurred. Use the GetLastError function to obtain extended error information.