Макрос TraceLoggingLevel (traceloggingprovider.h)

Макрос-оболочка TraceLogging , который задает уровень для события.

Синтаксис

void TraceLoggingLevel(
  [in]  eventLevel
);

Параметры

[in] eventLevel

8-разрядное число, используемое для описания серьезности или важности события. Это значение должно быть константой времени компиляции в диапазоне от 0 до 255. Если для вызова TraceLoggingWrite не указаны аргументы TraceLoggingLevel, уровень события по умолчанию будет 5 (WINEVENT_LEVEL_VERBOSE).

Важно!

ProviderId, Level и Keyword являются основными средствами фильтрации событий. Другие виды фильтрации возможны, но имеют гораздо более высокие издержки. Всегда назначайте значимый уровень и ключевое слово каждому событию.

Дополнительные сведения об уровне событий см. в разделе EVENT_DESCRIPTOR .

Возвращаемое значение

None

Remarks

TraceLoggingLevel(eventLevel) можно использовать в качестве параметра для вызова макроса TraceLoggingWrite для задания уровня события. Уровень событий является основным средством фильтрации событий. Всегда назначайте каждому событию значимый (ненулевой) уровень.

Если для вызова TraceLoggingWrite не предоставлены макросы TraceLoggingLevel, уровень события по умолчанию — 5 (WINEVENT_LEVEL_VERBOSE). Если предоставлено несколько макросов TraceLoggingLevel , используется последнее значение.

Значения уровней от 0 до 5 определяются корпорацией Майкрософт (см. evntrace.h и winmeta.h). Значения уровней от 6 до 15 зарезервированы для будущих определений корпорацией Майкрософт. Значения уровней от 16 до 255 могут быть определены поставщиком событий.

Значение Семантика
LOG_ALWAYS (0) Событие обходит фильтрацию событий на основе уровня. События не должны использовать этот уровень.
КРИТИЧЕСКОЕ (1) Критическая ошибка
ОШИБКА (2) Ошибка
ПРЕДУПРЕЖДЕНИЕ (3) Предупреждение
INFO (4) Informational
VERBOSE (5) Подробный

Сеансы сбора событий могут задавать фильтр уровня, то есть сеанс будет принимать события только в eventDescriptor.Level <= session.LevelFilter. Обратите внимание, что события с уровнем 0 будут обходить фильтрацию на основе уровней.

Примеры

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

Требования

Требование Значение
Минимальная версия клиента Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header traceloggingprovider.h

См. также раздел

EVENT_DESCRIPTOR

TraceLoggingWrite

Макросы-оболочки TraceLogging