setAclInformation 函数 (securitybaseapi.h)

SetAclInformation 函数 (ACL) 设置有关访问控制列表的信息。

语法

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

parameters

[in, out] pAcl

指向 ACL 的指针。 函数设置此 ACL 中的信息。

[in] pAclInformation

指向包含要设置的信息的缓冲区的指针。 这必须是指向 ACL_REVISION_INFORMATION 结构的指针。

[in] nAclInformationLength

pAclInfo 参数指向的缓冲区的大小(以字节为单位)。

[in] dwAclInformationClass

提供所请求信息的类的 ACL_INFORMATION_CLASS 枚举类型。

目前,此参数可以是 AclRevisionInformation。 这意味着 pAclInformation 参数指向的缓冲区包含 ACL_REVISION_INFORMATION 结构。

返回值

如果函数成功,则函数返回非零值。

如果函数失败,则返回零。 要获得更多的错误信息,请调用 GetLastError。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 securitybaseapi.h (包括 Windows.h)
Library Advapi32.lib
DLL Advapi32.dll

请参阅

ACL_INFORMATION_CLASS

ACL_REVISION_INFORMATION

GetAclInformation

InitializeAcl

IsValidAcl

低级别访问控制

低级别访问控制函数