getTraceLoggerHandle 函数 (evntrace.h)

基于 RegisterTraceGuids 的 (“Classic”) 事件提供程序使用 GetTraceLoggerHandle 函数检索应向其写入事件的事件跟踪会话的句柄。

提供程序从其 ControlCallback 函数调用此函数。

语法

TRACEHANDLE WMIAPI GetTraceLoggerHandle(
  [in] PVOID Buffer
);

[in] Buffer

指向 WNODE_HEADER 结构的指针。 ETW 将此结构传递给 Buffer 参数中的提供程序的 ControlCallback 函数。

WNODE_HEADER 的 HistoricalContext 成员包含会话的句柄。

如果函数成功，它将返回事件跟踪会话句柄。

如果函数失败，它将返回 INVALID_HANDLE_VALUE。若要获得更多的错误信息，请调用 GetLastError 函数。

调用 GetTraceEnableFlags 和 GetTraceEnableLevel 函数时，可以使用句柄来检索传递给 EnableTrace 函数的启用标志和级别值。

有关使用 GetTraceLoggerHandle 的示例，请参阅使用 MOF 检索事件数据。