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 执行以下操作:
- 调用 EventRegister 以打开与 ETW 的连接。
- 如果 EventRegister 成功,请使用 InformationClassEventProviderSetTraits 调用 TraceLoggingSetInformation 来配置 TraceLogging 支持的提供程序。
对 TraceLoggingRegister 的调用与对 TraceLoggingRegisterEx 的调用相同,对于 回调 和 上下文 参数使用 NULL。 如果需要在会话启用或禁用提供程序时收到 ETW 启用回调,请使用 TraceLoggingRegisterEx 。
要求
最低受支持的客户端 | Windows Vista [桌面应用 | UWP 应用] |
最低受支持的服务器 | Windows Server 2008 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | traceloggingprovider.h |
Library | Advapi32.lib |
DLL | 不可用 |
请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈