SetAclInformation function (securitybaseapi.h)

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

Syntax

BOOL SetAclInformation(
  [in, out] PACL                  pAcl,
  [in]      LPVOID                pAclInformation,
  [in]      DWORD                 nAclInformationLength,
  [in]      ACL_INFORMATION_CLASS dwAclInformationClass
);

Parameters

[in, out] pAcl

A pointer to an ACL. The function sets information in this ACL.

[in] pAclInformation

A pointer to a buffer that contains the information to be set. This must be a pointer to an ACL_REVISION_INFORMATION structure.

[in] nAclInformationLength

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

[in] dwAclInformationClass

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 value

If the function succeeds, the function returns nonzero.

If the function fails, it returns zero. To get extended error information, call GetLastError.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	securitybaseapi.h (include Windows.h)
Library	Advapi32.lib
DLL	Advapi32.dll

See also

ACL_INFORMATION_CLASS

ACL_REVISION_INFORMATION

GetAclInformation

InitializeAcl

IsValidAcl

Low-level Access Control

Low-level Access Control Functions