securitybaseapi.h (GetAclInformation 函式)

發行項
03/01/2024

GetAclInformation 函式會擷取訪問控制清單的相關信息， (ACL) 。

語法

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

參數

[in] pAcl

ACL 的指標。函式會擷取此 ACL 的相關信息。如果傳遞 Null 值，函式會造成存取違規。

[out] pAclInformation

要接收所要求信息的緩衝區指標。放入緩衝區的結構取決於 dwAclInformationClass 參數中所要求的信息類別。

[in] nAclInformationLength

pAclInformation 參數所指向緩衝區的大小，以位元組為單位。

[in] dwAclInformationClass

指出所要求資訊類別的 ACL_INFORMATION_CLASS 列舉值。這個參數可以是這個列舉中兩個值的其中一個：

如果值為 AclRevisionInformation，函式會以ACL_REVISION_INFORMATION結構填入 pAclInformation 參數指向的緩衝區。
如果值為 AclSizeInformation，函式會以ACL_SIZE_INFORMATION結構填入 pAclInformation 參數指向的緩衝區。

傳回值

如果函式成功，函式會傳回非零。

如果函式失敗，則會傳回零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

規格需求

需求	值
最低支援的用戶端	Windows XP [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	securitybaseapi.h (包含 Windows.h)
程式庫	Advapi32.lib
Dll	Advapi32.dll