Функция 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.
Возвращаемое значение
| Возвращаемый код/значение | Описание |
|---|---|
|
Функция выполнена успешно. |
|
Сбой функции. Чтобы получить код ошибки, вызовите функцию GetLastError . |
Комментарии
Эту функцию необходимо вызвать, только если вы передаете флаг EvtQueryTolerateQueryErrors в EvtQuery или флаг EvtSubscribeTolerateQueryErrors в EvtSubscribe.
Примеры
Пример использования этой функции см. в разделе Запросы событий.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | winevt.h |
| Библиотека | Wevtapi.lib |
| DLL | Wevtapi.dll |