Compartir a través de

Función EvtGetEventInfo (winevt.h)

  • Artículo

Obtiene información que identifica la consulta XML estructurada que seleccionó el evento y el archivo de canal o registro que contenía el evento.

Sintaxis

BOOL EvtGetEventInfo(
  [in]  EVT_HANDLE            Event,
  [in]  EVT_EVENT_PROPERTY_ID PropertyId,
  [in]  DWORD                 PropertyValueBufferSize,
  [in]  PEVT_VARIANT          PropertyValueBuffer,
  [out] PDWORD                PropertyValueBufferUsed
);

Parámetros

[in] Event

Identificador de un evento para el que desea recuperar información.

[in] PropertyId

Marca que identifica la información que se va a recuperar. Por ejemplo, el identificador de consulta o la ruta de acceso. Para conocer los valores posibles, consulte la enumeración EVT_EVENT_PROPERTY_ID .

[in] PropertyValueBufferSize

Tamaño del búfer PropertyValueBuffer , en bytes.

[in] PropertyValueBuffer

Un búfer asignado por el autor de la llamada que recibirá la información. El búfer contiene un objeto EVT_VARIANT . Puede establecer este parámetro en NULL para determinar el tamaño de búfer necesario.

[out] PropertyValueBufferUsed

Tamaño, en bytes, 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

Código o valor devuelto Descripción
TRUE
 La función se ha realizado correctamente.
FALSE
 Error en la función. Use la función GetLastError para obtener el código de error.

Comentarios

Si la consulta que pasó a EvtQuery o EvtSubscribe era una XPath en lugar de una consulta XML estructurada, el identificador de consulta será cero y la ruta de acceso será la ruta de acceso que pasó a la función.

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