TRACELOGGING_DECLARE_PROVIDER 宏 (traceloggingprovider.h)
向前声明 TraceLogging 提供程序的句柄。
语法
void TRACELOGGING_DECLARE_PROVIDER(
[in] handleVariable
);
参数
[in] handleVariable
要转发声明的句柄名称。 这应该是使用 TRACELOGGING_DEFINE_PROVIDER 在 .c 或 .cpp 文件中定义的句 柄的名称。
返回值
无
备注
根据需要使用此宏来转发声明 TraceLogging 提供程序句柄,例如在组件的头文件中。 此宏不会为提供程序句柄分配存储。 若要使用提供程序,需要使用 TRACELOGGING_DEFINE_PROVIDER 来定义句柄,并使用 TraceLoggingRegister 来注册它。
类似于 TRACELOGGING_DECLARE_PROVIDER(MyProviderHandle)
的调用可视为类似于以下代码:
extern "C" const TraceLoggingHProvider MyProviderHandle;
注意
声明的 TRACELOGGING_DECLARE_PROVIDER
提供程序句柄具有模块范围。 它可以根据需要在 EXE、DLL 或 SYS 文件中使用,但不应与同一进程中的其他 DLL 共享。 每个 EXE、DLL 或 SYS 文件都应定义自己的提供程序句柄,并应执行自己的 Register 和 Unregister。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [桌面应用 | UWP 应用] |
最低受支持的服务器 | Windows Server 2008 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | traceloggingprovider.h |