Función EvtRender (winevt.h)

Representa un fragmento XML en función del contexto de representación que especifique.

Sintaxis

BOOL EvtRender(
  [in]  EVT_HANDLE Context,
  [in]  EVT_HANDLE Fragment,
  [in]  DWORD      Flags,
  [in]  DWORD      BufferSize,
  [in]  PVOID      Buffer,
  [out] PDWORD     BufferUsed,
  [out] PDWORD     PropertyCount
);

Parámetros

[in] Context

Identificador del contexto de representación que devuelve la función EvtCreateRenderContext . Este parámetro debe establecerse en NULL si el parámetro Flags está establecido en EvtRenderEventXml o EvtRenderBookmark.

[in] Fragment

Identificador de un evento o de un marcador. Establezca este parámetro en un identificador de marcador si el parámetro Flags está establecido en EvtRenderBookmark; de lo contrario, establezca en un identificador de eventos.

[in] Flags

Marca que identifica lo que se va a representar. Por ejemplo, todo el evento o propiedades específicas del evento. Para conocer los valores posibles, consulte la enumeración EVT_RENDER_FLAGS .

[in] BufferSize

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

[in] Buffer

Un búfer asignado por el autor de la llamada que recibirá la salida representada. El contenido es una cadena Unicode terminada en null si el parámetro Flags está establecido en EvtRenderEventXml o EvtRenderBookmark. De lo contrario, si Flags se establece en EvtRenderEventValues, el búfer contiene una matriz de estructuras de EVT_VARIANT ; una para cada propiedad especificada por el contexto de representación. El parámetro PropertyCount contiene el número de elementos de la matriz.

Puede establecer este parámetro en NULL para determinar el tamaño de búfer necesario.

[out] BufferUsed

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.

[out] PropertyCount

Número de las propiedades del parámetro Buffer si el parámetro Flags está establecido en EvtRenderEventValues; de lo contrario, cero.

Valor devuelto

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

Comentarios

Hay una relación uno a uno entre la matriz de expresiones XPath que especificó al llamar a la función EvtCreateRenderContext y la matriz los valores devueltos en el búfer.

Cuando se usa una EVT_HANDLE de esta función en la función EvtRender , la lista de valores devueltos por esa función consta de una matriz de estructuras de EVT_VARIANT , cada una de las cuales corresponde exactamente a una de las expresiones XPATH de la matriz de parámetros ValuePaths original en orden de apariencia. Cada una de estas EVT_VARIANT estructura contiene el valor identificado por su expresión XPATH correspondiente para el evento que se va a representar. Si no se encuentra ningún valor, la estructura EVT_VARIANT contiene NULL. Si hay varios valores, la estructura EVT_VARIANT contendrá el primer valor encontrado.

Tenga cuidado al comparar números de punto flotante en consultas XPath. Cualquier representación de cadena de un número de punto flotante es aproximada, por lo que el valor mostrado en XML podría no coincidir con el número almacenado con el evento. Los números de punto flotante deben compararse como menores o mayores que una constante.

Ejemplos

Para ver un ejemplo que muestra cómo usar esta función, vea Rendering Events and Bookmarking Events.

Requisitos

Requisito	Value
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

Consulte también

EvtCreateRenderContext