SetTraceCallback 函式 （evntrace.h）

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 函式來記錄事件的提供者的事件。

需求

另請參閱

事件回呼

進程追蹤

RemoveTrace回呼