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

另请参阅

TRACELOGGING_DEFINE_PROVIDER

TraceLoggingWrite

TraceLogging 包装宏