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


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

Возвращает текстовое сообщение, содержащее расширенные сведения об ошибке для текущей ошибки.

Синтаксис

DWORD EvtGetExtendedStatus(
  [in]  DWORD  BufferSize,
  [in]  LPWSTR Buffer,
  [out] PDWORD BufferUsed
);

Параметры

[in] BufferSize

Размер буфера буфера в символах.

[in] Buffer

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

[out] BufferUsed

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

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

Возвращаемое значение ERROR_SUCCESS, если вызов выполнен успешно; в противном случае — код ошибки Win32.

Комментарии

Эту функцию необходимо вызвать в потоке, который вызвал ошибку, и перед вызовом другой функции журнала событий Windows.

Функции EvtQuery и EvtSubscribe могут предоставлять расширенные сведения об ошибке, если возникла проблема с указанным XPath. Например, сведения об ошибке могут определить символ в XPath, где произошла ошибка синтаксического анализа. Чтобы получить расширенные сведения об ошибке для неправильно сформированного XPath, нельзя указать флаг EvtQueryTolerateQueryErrors при вызове EvtQuery или EvtSubscribe.

Требования

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