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

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

Синтаксис

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

Параметры

TraceId

[in] InformationClass

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

[out] TraceInformation

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

[in] InformationLength

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

[out, optional] ReturnLength

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

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

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

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

• ERROR_BAD_LENGTH

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

• ERROR_INVALID_PARAMETER

  Недопустимый параметр.

• ERROR_NOT_SUPPORTED

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

• Другое

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

Замечания

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

Требования

См. также

TRACE_QUERY_INFO_CLASS

TraceSetInformation