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

See also

ACL_INFORMATION_CLASS

ACL_REVISION_INFORMATION

GetAclInformation

InitializeAcl

IsValidAcl

Low-level Access Control

Low-level Access Control Functions