Función GetTraceEnableLevel (evntrace.h)

  • Artículo

Un proveedor de eventos basado en RegisterTraceGuids ("clásico") usa la función GetTraceEnableLevel para recuperar el nivel de habilitación especificado por el controlador de seguimiento para indicar qué nivel de eventos se van a rastrear.

Los proveedores llaman a esta función desde su función ControlCallback .

Sintaxis

UCHAR WMIAPI GetTraceEnableLevel(
  [in] TRACEHANDLE TraceHandle
);

Parámetros

[in] TraceHandle

Controle a una sesión de seguimiento de eventos, obtenida mediante una llamada a la función GetTraceLoggerHandle .

Valor devuelto

Devuelve el valor especificado en el parámetro EnableLevel al llamar a la función EnableTrace .

Para determinar si se produjo un error en la función o el controlador estableció las marcas de habilitación en 0, siga estos pasos:

  1. Llame a la función SetLastError para establecer el último error en ERROR_SUCCESS.
  2. Llame a la función GetTraceEnableLevel para recuperar el nivel de habilitación.
  3. Si el valor de nivel de habilitación es 0, llame a la función GetLastError para recuperar el último error conocido.
  4. Si el último error conocido es ERROR_SUCCESS, el controlador establece el nivel de habilitación en 0; De lo contrario, se produjo un error en la función GetTraceEnableLevel con el último error conocido.

Comentarios

Los proveedores usan este valor para controlar la gravedad de los eventos que genera. Por ejemplo, los proveedores pueden usar este valor para determinar si debe generar eventos informativos, de advertencia o de error.

Ejemplos

Para ver un ejemplo que usa GetTraceEnableLevel, consulte Recuperación de datos de eventos mediante MOF.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado evntrace.h
Library Advapi32.lib
Archivo DLL Advapi32.dll

Consulte también

GetTraceEnableFlags

GetTraceLoggerHandle