Macro TraceLoggingLevel (traceloggingprovider.h)

  • Artículo

Macro contenedora traceLogging que establece el nivel del evento.

Sintaxis

void TraceLoggingLevel(
  [in]  eventLevel
);

Parámetros

[in] eventLevel

Número de 8 bits que se usa para describir la gravedad o importancia de un evento. Este valor debe ser una constante en tiempo de compilación en el intervalo de 0 a 255. Si no se proporciona ningún argumento TraceLoggingLevel a una llamada TraceLoggingWrite , el nivel del evento tendrá como valor predeterminado 5 (WINEVENT_LEVEL_VERBOSE).

Importante

ProviderId, Level y Keyword son los medios principales para filtrar eventos. Otros tipos de filtrado son posibles, pero tienen una sobrecarga mucho mayor. Asigne siempre un nivel distinto de cero significativo y una palabra clave a cada evento.

Consulte EVENT_DESCRIPTOR para obtener más información sobre el nivel de evento.

Valor devuelto

None

Observaciones

TraceLoggingLevel(eventLevel) se puede usar como parámetro para una invocación de una macro TraceLoggingWrite para establecer el nivel del evento. El nivel de evento es un medio principal para filtrar eventos. Asigne siempre un nivel significativo (distinto de cero) a cada evento.

Si no se proporcionan macros TraceLoggingLevel a una llamada TraceLoggingWrite , el nivel predeterminado del evento es 5 (WINEVENT_LEVEL_VERBOSE). Si se proporcionan varias macros TraceLoggingLevel , se usa el último valor.

Microsoft define los valores de nivel 0 a 5 (consulte evntrace.h y winmeta.h). Microsoft reserva los valores de nivel 6 a 15 para la definición futura. El proveedor de eventos puede definir los valores de nivel de 16 a 255.

Valor Semántica
LOG_ALWAYS (0) El evento omite el filtrado de eventos basado en el nivel. Los eventos no deben usar este nivel.
CRITICAL (1) Error grave
ERROR (2) Error
ADVERTENCIA (3) Advertencia
INFO (4) Informativo
VERBOSE (5) Verbose

Las sesiones de recopilación de eventos pueden establecer un filtro de nivel, lo que significa que la sesión solo aceptará eventos en los que eventDescriptor.Level <= session.LevelFilter. Tenga en cuenta que los eventos con un nivel de 0 omitirán el filtrado basado en el nivel.

Ejemplos

TraceLoggingWrite(
    g_hMyProvider,
    "MyWarningEventName",
    TraceLoggingLevel(WINEVENT_LEVEL_WARNING), // Levels defined in <winmeta.h>
    TraceLoggingKeyword(MyNetworkingKeyword), // Provider-defined keyword
    TraceLoggingHResult(errorCode, "Error"));

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado traceloggingprovider.h

Consulte también

EVENT_DESCRIPTOR

TraceLoggingWrite

Macros contenedoras traceLogging