Función EvtGetExtendedStatus (winevt.h)

Obtiene un mensaje de texto que contiene la información de error extendida para el error actual.

Sintaxis

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

Parámetros

[in] BufferSize

Tamaño del búfer de búfer , en caracteres.

[in] Buffer

Un búfer de cadena asignado por el autor de la llamada que recibirá la información de error extendida. Puede establecer este parámetro en NULL para determinar el tamaño de búfer necesario.

[out] BufferUsed

Tamaño, en caracteres, del búfer asignado por el autor de la llamada que usó la función o el tamaño de búfer necesario si se produce un error en la función con ERROR_INSUFFICIENT_BUFFER.

Valor devuelto

El valor devuelto es ERROR_SUCCESS si la llamada se realizó correctamente; de lo contrario, un código de error win32.

Comentarios

Debe llamar a esta función en el subproceso que generó el error y antes de llamar a otra función de registro de eventos de Windows.

Las funciones EvtQuery y EvtSubscribe pueden proporcionar información de error extendida si hay un problema con el XPath especificado. Por ejemplo, la información de error puede identificar el carácter en XPath donde se produjo un error de análisis. Para recibir la información de error extendida de un XPath con formato incorrecto, no se puede especificar la marca EvtQueryTolerateQueryErrors al llamar a EvtQuery o EvtSubscribe.

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winevt.h
Library	Wevtapi.lib
Archivo DLL	Wevtapi.dll