| 术语 | createtraceinstanceid |
| 释义 | CreateTraceInstanceId 语法： C++ ULONG CreateTraceInstanceId( __in HANDLE RegHandle, __out PEVENT_INSTANCE_INFO pInstInfo ); CreateTraceInstanceId功能 该CreateTraceInstanceId函数创建一个独特的交易标识符映射到一类GUID登记处理。然后使用事务标识符TraceEventInstance时调用函数。 参数 RegHandle [in] 句柄注册事件跟踪类。该RegisterTraceGuids函数返回此处理的TRACE_GUID_REGISTRATION结构RegHandle成员。 pInstInfo [out] 指针的EVENT_INSTANCE_INFO结构。这一结构InstanceId成员包含的事务标识符。 返回值 如果函数成功，则返回值为ERROR_SUCCESS。 如果函数失败，返回值是系统错误代码之一。下表列出了一些常见的错误及其原因。 返回codeDescription 以下ERROR_INVALID_PARAMETEROne是正确的： RegHandle为NULL。 pInstInfo为NULL。 备注 供应商调用这个函数。 ETW创建的用户标识符模式的过程，因此它可以返回了不同的过程相同。价值始于1时InstanceId以上达到了ULONG最大值。只有用户模式供应商可以调用CreateTraceInstanceId功能;驱动程序不能调用这个函数。 实例 对于使用CreateTraceInstanceId例如，见跟踪事件实例。 要求： 最低支持：client－Windows 2000专业版 最低支持server－Windows 2000服务器 HeaderEvntrace.h LibraryAdvapi32.lib DLLAdvapi32.dll 参见 RegisterTraceGuids TraceEventInstance 如果有任何问题和意见，请发送给微软(wsddocfb@microsoft.com) 生成日期：2009年7月30日 ＝＝英文原文＝＝CreateTraceInstanceId Function The CreateTraceInstanceId function creates a unique transaction identifier and maps it to a class GUID registration handle. You then use the transaction identifier when calling the TraceEventInstance function. Syntax C++ ULONG CreateTraceInstanceId( __in HANDLE RegHandle, __out PEVENT_INSTANCE_INFO pInstInfo ); Parameters RegHandle [in] Handle to a registered event trace class. The RegisterTraceGuids function returns this handle in the RegHandle member of the TRACE_GUID_REGISTRATION structure. pInstInfo [out] Pointer to an EVENT_INSTANCE_INFO structure. The InstanceId member of this structure contains the transaction identifier. Return Value If the function is successful, the return value is ERROR_SUCCESS. If the function fails, the return value is one of the system error codes . The following table includes some common errors and their causes. Return codeDescription ERROR_INVALID_PARAMETEROne of the following is true: RegHandle is NULL. pInstInfo is NULL. Remarks Providers call this function. ETW creates the identifier in the user-mode process, thus it can return the same number for different processes. The value starts over at one when InstanceId reaches the maximum value for a ULONG. Only user-mode providers can call the CreateTraceInstanceId function; drivers cannot call this function. Examples For an example that uses CreateTraceInstanceId, see Tracing Event Instances . Requirements Minimum supported clientWindows 2000 Professional Minimum supported serverWindows 2000 Server HeaderEvntrace.h LibraryAdvapi32.lib DLLAdvapi32.dll See Also RegisterTraceGuids TraceEventInstance Send comments about this topic to Microsoft Build date: 7/30/2009 ＝＝原始网址＝＝http://msdn.microsoft.com/en-us/library/aa363698(VS.85).aspx\n |
| 随便看 |
|
windows api函数参考手册包含2258条windows api函数文档，详细介绍nodejs、java、rust调用windows api的方法技巧，是学习windows api编程的入门中文文档。