(securitybaseapi.h) SetAclInformation 函式

發行項
08/25/2023

SetAclInformation 函式會設定存取控制清單的相關資訊， (ACL) 。

語法

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

參數

[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)
程式庫	Advapi32.lib
Dll	Advapi32.dll