Функция EvtGetQueryInfo (winevt.h)

  • Статья

Возвращает сведения о выполненном запросе, который идентифицирует список каналов или файлов журналов, к которым запрос пытался получить доступ. Функция также получает список кодов возврата, указывающих на успешное или неудачное выполнение каждого доступа.

Синтаксис

BOOL EvtGetQueryInfo(
  [in]  EVT_HANDLE            QueryOrSubscription,
  [in]  EVT_QUERY_PROPERTY_ID PropertyId,
  [in]  DWORD                 PropertyValueBufferSize,
  [in]  PEVT_VARIANT          PropertyValueBuffer,
  [out] PDWORD                PropertyValueBufferUsed
);

Параметры

[in] QueryOrSubscription

Дескриптор запроса, возвращаемого функциейEvtQuery или EvtSubscribe .

[in] PropertyId

Идентификатор извлекаемой информации запроса. Список идентификаторов см. в перечислении EVT_QUERY_PROPERTY_ID .

[in] PropertyValueBufferSize

Размер буфера PropertyValueBuffer в байтах.

[in] PropertyValueBuffer

Выделенный вызывающим объектом буфер, который будет получать сведения о запросе. Буфер содержит объект EVT_VARIANT . Для этого параметра можно задать значение NULL , чтобы определить требуемый размер буфера.

[out] PropertyValueBufferUsed

Размер буфера, выделенного вызывающим объектом, который использовала функция, или требуемый размер буфера, если функция завершается сбоем с ERROR_INSUFFICIENT_BUFFER.

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

Возвращаемый код/значение Описание
TRUE
 Функция выполнена успешно.
FALSE
 Сбой функции. Чтобы получить код ошибки, вызовите функцию GetLastError .

Комментарии

Эту функцию необходимо вызвать, только если вы передаете флаг EvtQueryTolerateQueryErrors в EvtQuery или флаг EvtSubscribeTolerateQueryErrors в EvtSubscribe.

Примеры

Пример использования этой функции см. в разделе Запросы событий.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header winevt.h
Библиотека Wevtapi.lib
DLL Wevtapi.dll

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

EvtQuery

EvtSubscribe