术语 | gettraceenablelevel |
释义 | GetTraceEnableLevel 语法: C++ UCHAR GetTraceEnableLevel( __in TRACEHANDLE SessionHandle ); GetTraceEnableLevel功能 该GetTraceEnableLevel函数检索严重程度由控制器通过以指示记录提供者应履行的Level。 供应商只能从他们ControlCallback调用这个函数的功能。 参数 SessionHandle [in] 处理的事件跟踪会话,通过调用GetTraceLoggerHandle函数获得。 返回值 返回值参数的EnableLevel时指定调用EnableTrace功能控制器。 如果要判断函数失败或控制器,使标志设置为0,请按照下列步骤: 调用SetLastError函数来设置最后一个错误的ERROR_SUCCESS。 调用GetTraceEnableLevel函数来检索,使Level。 如果使Level值为0,调用GetLastError函数来检索最后一个已知的错误。 如果最近一次的错误ERROR_SUCCESS,控制器设置启用Level为0,否则,GetTraceEnableLevel功能的最后一个已知的错误失败。 备注 供应商使用此值来控制的事件的严重性,它生成。例如,供应商可以使用此值来判断是否应该产生信息,警告或错误事件。 实例 举一个例子,它使用GetTraceEnableLevel,看到实现一个ControlCallback功能。 要求: 最低支持:client-Windows 2000专业版 最低支持server-Windows 2000服务器 HeaderEvntrace.h LibraryAdvapi32.lib DLLAdvapi32.dll 参见 GetTraceEnableFlags GetTraceLoggerHandle 如果有任何问题和意见,请发送给微软(wsddocfb@microsoft.com) 生成日期:2009年7月30日 ==英文原文==GetTraceEnableLevel Function The GetTraceEnableLevel function retrieves the severity level passed by the controller to indicate the level of logging the provider should perform. Providers can only call this function from their ControlCallback function. Syntax C++ UCHAR GetTraceEnableLevel( __in TRACEHANDLE SessionHandle ); Parameters SessionHandle [in] Handle to an event tracing session, obtained by calling the GetTraceLoggerHandle function. Return Value Returns the value the controller specified in the EnableLevel parameter when calling the EnableTrace function. To determine if the function failed or the controller set the enable flags to 0, follow these steps: Call the SetLastError function to set the last error to ERROR_SUCCESS. Call the GetTraceEnableLevel function to retrieve the enable level. If the enable level value is 0, call the GetLastError function to retrieve the last known error. If the last known error is ERROR_SUCCESS, the controller set the enable level to 0; otherwise, the GetTraceEnableLevel function failed with the last known error. Remarks Providers use this value to control the severity of events that it generates. For example, providers can use this value to determine if it should generate informational, warning, or error events. Examples For an example that uses GetTraceEnableLevel, 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 GetTraceLoggerHandle Send comments about this topic to Microsoft Build date: 7/30/2009 ==原始网址==http://msdn.microsoft.com/en-us/library/aa363894(VS.85).aspx\n |
随便看 |
|
windows api函数参考手册包含2258条windows api函数文档,详细介绍nodejs、java、rust调用windows api的方法技巧,是学习windows api编程的入门中文文档。