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 中定義的下列其中一個錯誤碼。

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

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

注意

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