WMIDPREQUEST 回调函数 (evntrace.h)

项目
02/26/2024

基于 RegisterTraceGuids 的 (“Classic”) 事件提供程序实现此函数以接收来自控制器的启用或禁用通知请求。

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 函数。

回调函数不得调用任何可能导致 LoadLibrary 的任何内容，更具体地说， (，任何需要加载程序锁) 。

示例

有关 ControlCallback 函数的示例实现，请参阅编写经典事件。

要求

要求	值
最低受支持的客户端	Windows 2000 专业版 [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows 2000 Server [桌面应用 \|UWP 应用]
目标平台	Windows
标头	evntrace.h