SetAclInformation

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

BOOL SetAclInformation(
  PACL pAcl,                                  // access-control list
  LPVOID pAclInformation,                     // ACL information
  DWORD nAclInformationLength,                // size of ACL information
  ACL_INFORMATION_CLASS dwAclInformationClass // class
);

Parameters

pAcl

[in] Pointer to an ACL structure. The function sets information in this ACL.

pAclInformation

[out] Pointer to a buffer containing the information to be set. This must be a pointer to an ACL_REVISION_INFORMATION structure.

nAclInformationLength

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

dwAclInformationClass

[in] 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.

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Header: Declared in Winbase.h; include Windows.h.
  Library: Use Advapi32.lib.

See Also

Low-Level Access-Control Overview, Low-Level Access Control Functions, ACL, ACL_INFORMATION_CLASS, ACL_REVISION_INFORMATION, GetAclInformation, InitializeAcl, IsValidAcl