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

以下其中一項為正確：
- pGuid 為 NULL。
- EventCallback 為 NULL。

取用者會呼叫此函式。

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

若要停止回呼函式接收事件追蹤類別的事件，請呼叫 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