Funzione EvtRender (winevt.h)

Articolo
08/27/2023

Esegue il rendering di un frammento XML in base al contesto di rendering specificato.

Sintassi

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
);

Parametri

[in] Context

Handle per il contesto di rendering restituito dalla funzione EvtCreateRenderContext . Questo parametro deve essere impostato su NULL se il parametro Flags è impostato su EvtRenderEventXml o EvtRenderBookmark.

[in] Fragment

Handle di un evento o di un segnalibro. Impostare questo parametro su un handle di segnalibro se il parametro Flags è impostato su EvtRenderBookmark; in caso contrario, impostare su un handle di evento.

[in] Flags

Flag che identifica gli elementi di cui eseguire il rendering. Ad esempio, l'intero evento o proprietà specifiche dell'evento. Per i valori possibili, vedere l'enumerazione EVT_RENDER_FLAGS .

[in] BufferSize

Dimensioni del buffer buffer , in byte.

[in] Buffer

Buffer allocato dal chiamante che riceverà l'output sottoposto a rendering. Il contenuto è una stringa Unicode con terminazione Null se il parametro Flags è impostato su EvtRenderEventXml o EvtRenderBookmark. In caso contrario, se Flags è impostato su EvtRenderEventValues, il buffer contiene una matrice di strutture EVT_VARIANT ; uno per ogni proprietà specificata dal contesto di rendering. Il parametro PropertyCount contiene il numero di elementi nella matrice.

È possibile impostare questo parametro su NULL per determinare le dimensioni del buffer necessarie.

[out] BufferUsed

Dimensione, in byte, del buffer allocato dal chiamante utilizzato dalla funzione o dalla dimensione del buffer necessaria se la funzione ha esito negativo con ERROR_INSUFFICIENT_BUFFER.

[out] PropertyCount

Numero delle proprietà nel parametro Buffer se il parametro Flags è impostato su EvtRenderEventValues; in caso contrario, zero.

Valore restituito

Codice/valore restituito	Descrizione
TRUE	Funzione completata.
FALSE	La funzione non è riuscita. Chiamare la funzione GetLastError per ottenere il codice di errore.

Commenti

Esiste una relazione uno-a-uno tra la matrice di espressioni XPath specificate quando è stata chiamata la funzione EvtCreateRenderContext e la matrice i valori restituiti nel buffer.

Quando una EVT_HANDLE da questa funzione viene utilizzata nella funzione EvtRender , l'elenco di valori restituiti da tale funzione è costituito da una matrice di strutture EVT_VARIANT , ognuna corrispondente esattamente a una delle espressioni XPATH nella matrice di parametri ValuePaths originale in ordine di aspetto. Ogni struttura EVT_VARIANT contiene il valore identificato dall'espressione XPATH corrispondente per l'evento di cui viene eseguito il rendering. Se non viene trovato alcun valore, la struttura EVT_VARIANT contiene NULL. Se sono presenti più valori, la struttura EVT_VARIANT conterrà il primo valore rilevato.

Prestare attenzione quando si confrontano i numeri a virgola mobile nelle query XPath. Qualsiasi rappresentazione di stringa di un numero a virgola mobile è approssimativa, pertanto il valore visualizzato in XML potrebbe non corrispondere al numero archiviato con l'evento. I numeri a virgola mobile devono essere confrontati come minori o maggiori di una costante.

Esempio

Per un esempio che illustra come usare questa funzione, vedere Rendering events and Bookmarking Events .For an example that shows how to use this function, see Rendering Events and Bookmarking Events.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winevt.h
Libreria	Wevtapi.lib
DLL	Wevtapi.dll

Vedi anche

EvtCreateRenderContext

Condividi tramite