Función GetTraceEnableLevel (evntrace.h)
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:
- Llame a la función SetLastError para establecer el último error en ERROR_SUCCESS.
- Llame a la función GetTraceEnableLevel para recuperar el nivel de habilitación.
- Si el valor de nivel de habilitación es 0, llame a la función GetLastError para recuperar el último error conocido.
- 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 |