AuditQueryGlobalSaclA 函式（ntsecapi.h）

AuditQueryGlobalSacl 函式會擷取委派稽核訊息存取權的全域系統存取控制清單（SACL）。更新全域 SACL 需要 SeSecurityPrivilege，以保護全域 SACL 不受系統管理員許可權的任何使用者更新。

語法

BOOLEAN AuditQueryGlobalSaclA(
  [in]  PCSTR ObjectTypeName,
  [out] PACL  *Acl
);

[in] ObjectTypeName

指定所存取物件類型的 Null 終止字串指標。此參數必須是「File」或「Key」，視物件為檔案或登錄而定。此字串會出現在任何函式產生的稽核訊息中。

[out] Acl

包含 SACL 資訊的 ACL 結構的指標。稍後應該藉由呼叫 LocalFree 函式來釋出。

如果函式成功，它會 TRUE傳回。

如果函式失敗，它會 FALSE傳回。若要取得擴充的錯誤資訊，請呼叫 GetLastError。 GetLastError 可能會傳回 WinError.h 中定義的下列其中一個錯誤碼。

傳回碼/值	描述
ERROR_ACCESS_DENIED 5	呼叫端沒有呼叫此函式所需的許可權或訪問許可權。
ERROR_INVALID_PARAMETER 87	一或多個參數無效。

若要成功呼叫此函式，呼叫端必須 SeSecurityPrivilege。

注意

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