AuditSetGlobalSaclA 函式（ntsecapi.h）

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

語法

BOOLEAN AuditSetGlobalSaclA(
  [in]           PCSTR ObjectTypeName,
  [in, optional] PACL  Acl
);

[in] ObjectTypeName

指定所建立或存取物件類型的 Null 終止字串指標。若要在檔案上設定全域 SACL，這應該設定為 “File”，而針對在登錄上設定全域 SACL，這應該設定為 “Key”。此字串會出現在任何函式產生的稽核訊息中。

[in, optional] Acl

ACL 結構的指標。

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

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

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

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

注意

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