AuditSetPerUserPolicy 函式 (ntsecapi.h)

  • 發行項

AuditSetPerUserPolicy 函式會在指定主體的一或多個稽核子類別中設定每個使用者稽核原則。

語法

BOOLEAN AuditSetPerUserPolicy(
  [in] const PSID                 pSid,
  [in] PCAUDIT_POLICY_INFORMATION pAuditPolicy,
  [in] ULONG                      dwPolicyCount
);

參數

[in] pSid

與要設定稽核原則之主體相關聯的 SID 結構的指標。 目前不支援群組 SID 的個別用戶原則。

[in] pAuditPolicy

AUDIT_POLICY_INFORMATION 結構的陣列指標。 每個結構都會指定一個稽核子類別的每個使用者稽核原則。

系統會忽略這些結構的 AuditCategoryGuid 成員。

[in] dwPolicyCount

pAuditPolicy 陣列中的元素數目。

傳回值

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

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

傳回碼/值 Description
ERROR_ACCESS_DENIED
5
 呼叫端沒有呼叫此函式所需的許可權或訪問許可權。
ERROR_INVALID_PARAMETER
87
 一或多個參數無效。
ERROR_NO_SUCH_USER
1317
 pSID 參數指定的 SID 結構與現有用戶無關。

備註

若要成功呼叫此函式，呼叫端必須具有 SeSecurityPrivilege 或具有稽核安全性物件的AUDIT_SET_USER_POLICY存取權。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 ntsecapi.h
程式庫 Advapi32.lib
Dll Advapi32.dll

另請參閱

AuditQueryPerUserPolicy

AuditQuerySystemPolicy

AuditSetSystemPolicy