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

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

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

注意

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