TraceLoggingRegisterEx 函数 (traceloggingprovider.h)

注册 TraceLogging 提供程序,以便可用于记录事件,并指定 ETW 启用回调。 注册在取消注册提供程序或进程退出之前有效。

语法

TLG_STATUS TraceLoggingRegisterEx(
  [in, out]      TraceLoggingHProvider hProvider,
  [in, optional] TLG_PENABLECALLBACK   pEnableCallback,
  [in, optional] PVOID                 pCallbackContext
);

参数

[in, out] hProvider

要注册的 TraceLogging 提供程序的句柄。 句柄必须尚未注册。

[in, optional] pEnableCallback

ETW 启用回调 ,在跟踪会话启用或禁用提供程序时将调用该回调。

[in, optional] pCallbackContext

要传递给回调的提供程序定义的可选上下文指针。

返回值

如果从用户模式代码调用此函数,该函数将 HRESULT返回 。 SUCCEEDED()使用 宏确定函数是否成功。

如果从内核模式代码调用此函数,该函数将 NTSTATUS返回 。 NT_SUCCESS()使用 宏确定函数是否成功。

注意

TraceLoggingRegisterEx 返回的错误代码主要用于调试和诊断方案。 即使 ETW 提供程序注册失败,大多数生产代码也应继续运行,因此发布版本通常应忽略 TraceLoggingRegisterEx 返回的错误代码。

注解

有关注册提供程序的详细信息 ,请参阅 TraceLoggingRegister 。 有关回调行为的详细信息,请参阅 ETW 启用 回调。

TraceLoggingRegisterEx 执行以下操作:

TraceLoggingRegister 的调用与对 TraceLoggingRegisterEx 的调用相同,对于 回调上下文 参数使用 NULL。 如果需要在会话启用或禁用提供程序时收到 ETW 启用回调,请使用 TraceLoggingRegisterEx

要求

   
最低受支持的客户端 Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 traceloggingprovider.h
Library Advapi32.lib
DLL 不可用

请参阅

ETW 启用回调

EventRegister

TraceLoggingRegister

TraceLoggingUnregister

TraceLoggingWrite

TRACELOGGING_DEFINE_PROVIDER