WMIDPREQUEST 回呼函式 (evntrace.h)

發行項
02/26/2024

RegisterTraceGuids 型 (「傳統」) 事件提供者會實作此函式，以接收控制器的啟用或停用通知要求。

WMIDPREQUEST 類型會定義這個回呼函式的指標。 ControlCallback 是應用程式定義函數名稱的佔位元。

語法

WMIDPREQUEST Wmidprequest;

ULONG Wmidprequest(
  [in] WMIDPREQUESTCODE RequestCode,
       PVOID RequestContext,
       ULONG *BufferSize,
  [in] PVOID Buffer
)
{...}

參數

[in] RequestCode

要求程序代碼。這會是下列其中一個值。

值	意義
WMI_ENABLE_EVENTS	啟用提供者或變更提供者組態。
WMI_DISABLE_EVENTS	停用此提供者。

RequestContext

提供者定義的內容。提供者使用 的 RequestContext 參數
RegisterTraceGuids 以指定內容。

BufferSize

保留供內部使用。

[in] Buffer

WNODE_HEADER 結構的指標，其中包含啟用或停用提供者的事件追蹤會話相關信息。

傳回值

如果回呼成功，您應該傳回ERROR_SUCCESS。請注意，ETW 會忽略此函式的傳回值，除非控制器呼叫 EnableTrace 來啟用提供者，而且提供者尚未呼叫 RegisterTraceGuids。發生這種情況時，如果註冊成功， RegisterTraceGuids 會傳回此回呼的傳回值。

備註

此函式是使用 RegisterTraceGuids 函式來指定。當控制器呼叫 EnableTrace 函式以啟用、停用或變更啟用旗標或層級時，ETW 會呼叫此回呼。提供者會根據 RequestCode 值啟用或停用本身。一般而言，提供者會使用此值來設定全域旗標，以指出其啟用狀態。

提供者會定義其啟用或停用的解譯。一般而言，如果啟用提供者，它會產生事件，但停用時則不會。

ETW 不會傳遞啟用旗標，也不會將控制器傳遞給 EnableTrace 函式的啟用層級傳遞至此回呼。若要擷取此資訊，請分別呼叫 GetTraceEnableFlags 和 GetTraceEnableLevel 函式。

您也需要在此回呼中擷取會話句柄，以供日後呼叫使用。若要擷取會話句柄，請呼叫 GetTraceLoggerHandle 函式。

您的回呼函式不得呼叫可能更具體地產生 LoadLibra (ry 的任何專案，任何需要載入器鎖定) 的專案。

範例

如需 ControlCallback 函式的範例實作，請參閱撰寫傳統事件。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	evntrace.h