共用方式為


SetTraceCallback 函式 (evntrace.h)

重要

請勿使用此函式;後續版本可能無法使用。 相反地,篩選 EventRecordCallback 函式中的事件追蹤類別。

SetTraceCallback 函式會指定 EventCallback 函式來處理指定事件追蹤類別的事件。

語法

ULONG WMIAPI SetTraceCallback(
  [in] LPCGUID         pGuid,
  [in] PEVENT_CALLBACK EventCallback
);

參數

[in] pGuid

您要接收事件之事件追蹤類別的類別 GUID 指標。 如需核心提供者類別 GUID 的清單,請參閱 NT 核心記錄器常數

[in] EventCallback

EventCallback 函式的指標,用來處理屬於事件追蹤類別的事件。

傳回值

如果函式成功,傳回值會ERROR_SUCCESS。

如果函式失敗,傳回值就是其中一個 系統錯誤碼。 以下是一些常見的錯誤及其原因。

  • ERROR_INVALID_PARAMETER

    以下其中一項為正確:

    • pGuidNULL
    • EventCallbackNULL

備註

取用者會呼叫此函式。

您只能為事件追蹤類別指定一個回呼函式。 如果您為事件追蹤類別指定多個回呼函式,則最後一個回呼函式會收到該事件追蹤類別的事件。

若要停止回呼函式接收事件追蹤類別的事件,請呼叫 RemoveTraceCallback 函式。 當您關閉追蹤時,回呼會自動停止接收回呼。

您可以使用此函式來接收使用其中一個 TraceEvent 函式所撰寫的事件。 您無法使用此函式從使用其中一個 EventWrite 函式來記錄事件的提供者取用事件。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 evntrace.h
程式庫 Windows 8.1 和 Windows Server 2012 R2 上的 Sechost.lib;Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2、Windows Server 2008、Windows Vista 和 Windows XP 上的 Advapi32.lib
Dll Sechost.dll Windows 8.1 和 Windows Server 2012 R2;Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2、Windows Server 2008、Windows Vista 和 Windows XP 上的 Advapi32.dll

另請參閱

EventCallback

ProcessTrace

RemoveTraceCallback