AuthzRegisterSecurityEventSource 函式 (authz.h)

AuthzRegisterSecurityEventSource 函式會向 Local Security Authority (LSA) 註冊安全性事件來源。

語法

AUTHZAPI BOOL AuthzRegisterSecurityEventSource(
  [in]  DWORD                                 dwFlags,
  [in]  PCWSTR                                szEventSourceName,
  [out] PAUTHZ_SECURITY_EVENT_PROVIDER_HANDLE phEventProvider
);

參數

[in] dwFlags

這個參數保留給未來使用。 將此參數設定為零。

[in] szEventSourceName

要註冊之安全性事件來源名稱的指標。

[out] phEventProvider

已註冊安全性事件來源句柄的指標。

傳回值

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

如果函式失敗，則會傳回 FALSE。 如需擴充的錯誤資訊，請呼叫 GetLastError。

備註

此函式會驗證 szEventSourceName 參數，並設定適當的結構和 RPC 連線，以使用該來源名稱記錄事件。 驗證是由 LSA API 的基礎呼叫所處理。

LSA API 會驗證下列各項：

• 呼叫端具有 SeAuditPrivilege 訪問許可權。
• 事件來源尚未使用中。
• 事件來源已註冊。
• 如果事件來源註冊存在，呼叫端應用程式就會比對可執行映射路徑。

規格需求

另請參閱

AuthzUnregisterSecurityEventSource