AuditSetSecurity 函式 (ntsecapi.h)

  • 發行項

AuditSetSecurity 函式會設定可委派稽核原則存取權的安全性描述元。

語法

BOOLEAN AuditSetSecurity(
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

參數

[in] SecurityInformation

SECURITY_INFORMATION值，指定此函式所設定的安全性描述元的哪些部分。 僅支援 SACL_SECURITY_INFORMATION 和 DACL_SECURITY_INFORMATION 。 會忽略任何其他值。 如果未指定 SACL_SECURITY_INFORMATION 或 DACL_SECURITY_INFORMATION ，則此函式會失敗並傳回 ERROR_INVALID_PARAMETER。

[in] pSecurityDescriptor

格式正確的 SECURITY_DESCRIPTOR 結構的指標，可控制 稽核安全性物件的存取權。 如果此參數為 NULL，則函式會失敗，並傳回 ERROR_INVALID_PARAMETER。

傳回值

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

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

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

備註

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

規格需求

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

另請參閱

AuditQuerySecurity