GetAuditedPermissionsFromAclA 函式（aclapi.h）

發行項
11/20/2024

GetAuditedPermissionsFromAcl 函式會擷取指定信任項的稽核訪問許可權。稽核的許可權是以指定之訪問控制清單（ACL）（ACL）的存取控制項目為基礎。稽核的訪問許可權表示導致系統在系統事件記錄檔中產生稽核記錄的存取嘗試類型。稽核的許可權包括 ACL 指定信任者或信任者為成員的任何群組。在判斷稽核的許可權時，函式不會考慮受託人所持有的安全性許可權。

語法

DWORD GetAuditedPermissionsFromAclA(
  [in]  PACL         pacl,
  [in]  PTRUSTEE_A   pTrustee,
  [out] PACCESS_MASK pSuccessfulAuditedRights,
  [out] PACCESS_MASK pFailedAuditRights
);

參數

[in] pacl

要從中取得受託人稽核訪問許可權的 ACL 結構的指標。

[in] pTrustee

識別信任項之信任項結構的指標。信任者可以是使用者、群組或程式（例如 Windows 服務）。您可以使用名稱或安全性識別碼（SID）來識別信任者。如需 SID 結構的相關資訊，請參閱 SID。

[out] pSuccessfulAuditedRights

ACCESS_MASK 結構的指標，這個結構會針對由 pTrustee 參數所指定之信任項所稽核的許可權，接收成功稽核遮罩。當信任項成功使用這些訪問許可權時，系統會產生稽核記錄。

[out] pFailedAuditRights

ACCESS_MASK 結構的指標，這個結構會接收由 pTrustee 參數所指定之信任項所稽核許可權的失敗稽核遮罩。當信任項嘗試使用任何許可權時，系統會產生稽核記錄。

傳回值

如果函式成功，函式會傳回ERROR_SUCCESS。

如果函式失敗，它會傳回 WinError.h 中定義的非零錯誤碼。

言論

GetAuditedPermissionsFromAcl 函式會檢查 ACL 中的所有系統稽核 ACE，以判斷受託人的稽核許可權。針對指定群組稽核許可權的所有 ACE，GetAuditedPermissionsFromAcl 列舉群組的成員，以判斷信任項是否為成員。如果函式無法列舉群組的成員，函式會傳回錯誤。

注意

aclapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 GetAuditedPermissionsFromAcl 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求

要求	價值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平臺	窗戶
標頭	aclapi.h
連結庫	Advapi32.lib
DLL	Advapi32.dll