术语 | gettraceloggerhandle |
释义 | GetTraceLoggerHandle 语法: C++ TRACEHANDLE GetTraceLoggerHandle( __in PVOID Buffer ); GetTraceLoggerHandle功能 该GetTraceLoggerHandle函数检索处理的跟踪会话活动。 供应商只能从他们ControlCallback调用这个函数的功能。 参数 缓冲区 [in] 指针WNODE_HEADER结构。 ETW通过这个结构,以供应商的ControlCallback函数在缓冲区参数。 在WNODE_HEADER HistoricalContext成员包含会话的句柄。 返回值 如果函数成功,它将返回事件跟踪会话句柄。 如果函数失败,则返回INVALID_HANDLE_VALUE。为了获得更多错误信息,调用GetLastError函数。 备注 您使用处理时调用GetTraceEnableFlags和GetTraceEnableLevel检索功能,使旗传递给EnableTrace功能Level的值。 实例 举一个例子,它使用GetTraceLoggerHandle,看到实现一个ControlCallback功能。 要求: 最低支持:client-Windows 2000专业版 最低支持server-Windows 2000服务器 HeaderEvntrace.h LibraryAdvapi32.lib DLLAdvapi32.dll 参见 GetTraceEnableFlags GetTraceEnableLevel 如果有任何问题和意见,请发送给微软(wsddocfb@microsoft.com) 生成日期:2009年7月30日 ==英文原文==GetTraceLoggerHandle Function The GetTraceLoggerHandle function retrieves the handle of the event tracing session. Providers can only call this function from their ControlCallback function. Syntax C++ TRACEHANDLE GetTraceLoggerHandle( __in PVOID Buffer ); Parameters Buffer [in] Pointer to a WNODE_HEADER structure. ETW passes this structure to the provider's ControlCallback function in the Buffer parameter. The HistoricalContext member of WNODE_HEADER contains the session's handle. Return Value If the function succeeds, it returns the event tracing session handle. If the function fails, it returns INVALID_HANDLE_VALUE. To get extended error information, call the GetLastError function. Remarks You use the handle when calling the GetTraceEnableFlags and GetTraceEnableLevel functions to retrieve the enable flags and level values passed to the EnableTrace function. Examples For an example that uses GetTraceLoggerHandle, see Implementing a ControlCallback Function . Requirements Minimum supported clientWindows 2000 Professional Minimum supported serverWindows 2000 Server HeaderEvntrace.h LibraryAdvapi32.lib DLLAdvapi32.dll See Also GetTraceEnableFlags GetTraceEnableLevel Send comments about this topic to Microsoft Build date: 7/30/2009 ==原始网址==http://msdn.microsoft.com/en-us/library/aa363897(VS.85).aspx\n |
随便看 |
|
windows api函数参考手册包含2258条windows api函数文档,详细介绍nodejs、java、rust调用windows api的方法技巧,是学习windows api编程的入门中文文档。