Поделиться через

Функция TraceQueryInformation (evntrace.h)

  • Статья

Функция TraceQueryInformation предоставляет сведения о сеансе трассировки событий.

Синтаксис

ULONG WMIAPI TraceQueryInformation(
  [in]            TRACEHANDLE      SessionHandle,
  [in]            TRACE_INFO_CLASS InformationClass,
  [out]           PVOID            TraceInformation,
  [in]            ULONG            InformationLength,
  [out, optional] PULONG           ReturnLength
);

Параметры

[in] SessionHandle

Дескриптор сеанса трассировки событий, для которого вы собираете сведения. Функция StartTrace возвращает этот дескриптор при запуске новой трассировки. Чтобы получить дескриптор существующей трассировки, используйте ControlTrace для запроса свойств трассировки на основе имени трассировки, а затем получите дескриптор из поля Wnode.HistoricalContext возвращаемых EVENT_TRACE_PROPERTIES данных.

[in] InformationClass

Класс сведений для запроса. Сведения, которые захватывает класс, включаются в раздел расширенных данных события. Список информационных классов, которые можно запрашивать, см. в перечислении TRACE_QUERY_INFO_CLASS .

[out] TraceInformation

Указатель на буфер для получения возвращаемых данных класса информации. Класс information определяет содержимое этого параметра. Например, для класса сведений TraceStackTracingInfo этот параметр представляет собой массив CLASSIC_EVENT_ID структур. Структуры указывают идентификаторы GUID событий, для которых включена трассировка стека. Массив ограничен 256 элементами.

[in] InformationLength

Размер в байтах данных, возвращаемых в буфере TraceInformation . Если функция завершается сбоем, это значение указывает необходимый размер буфера TraceInformation .

[out, optional] ReturnLength

Указатель на значение, которое получает размер (в байтах) определенных данных, возвращаемых в буфере TraceInformation .

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

Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS.

Если функция завершается сбоем, возвращается один из следующих кодов ошибок.

  • ERROR_BAD_LENGTH

    Программа выдала команду, но длина команды неверна. Эта ошибка возвращается, если параметр InformationLength меньше минимального размера.

  • ERROR_INVALID_PARAMETER

    Неправильный параметр".

  • ERROR_NOT_SUPPORTED

    Запрос не поддерживается.

  • Другое

    Используйте FormatMessage , чтобы получить строку сообщения для возвращаемой ошибки.

Комментарии

Функция TraceQueryInformation запрашивает параметры сеанса трассировки событий из сеанса трассировки. Вызовите эту функцию после вызова StartTrace.

Требования

Требование Значение
Минимальная версия клиента Windows 8 [только классические приложения]
Минимальная версия сервера Windows Server 2012 [только классические приложения]
Целевая платформа Windows
Header evntrace.h
Библиотека Sechost.lib в Windows 8.1 и Windows Server 2012 R2; Advapi32.lib в Windows 8 и Windows Server 2012
DLL Sechost.dll в Windows 8.1 и Windows Server 2012 R2; Advapi32.dll в Windows 8 и Windows Server 2012

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

TRACE_QUERY_INFO_CLASS

TraceSetInformation