SetAclInformation info  Overview  Group

The SetAclInformation function sets information about an access-control list (ACL).

BOOL SetAclInformation(

PACL pAcl,	// address of access-control list
LPVOID pAclInformation,	// address of ACL information
DWORD nAclInformationLength,	// size of ACL information
ACL_INFORMATION_CLASS dwAclInformationClass	// specifies class of requested info
);

Parameters

pAcl

Points to an ACL structure. The function sets information in this ACL.

pAclInformation

Points to a buffer containing the information to be set. For the current version of Windows NT, this must be an ACL_REVISION_INFORMATION structure.

nAclInformationLength

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

dwAclInformationClass

Specifies an ACL_INFORMATION_CLASS enumerated type that gives the class of information requested.

Currently, this parameter can be AclRevisionInformation. This means that the buffer pointed to by the pAclInformation parameter contains an ACL_REVISION_INFORMATION structure.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

See Also

ACL, ACL_INFORMATION_CLASS, ACL_REVISION_INFORMATION, GetAclInformation, InitializeAcl, IsValidAcl