Функция 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
Указатель на буфер для получения возвращаемых данных класса информации. Класс 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 |