Funzione TdhGetEventInformation (tdh.h)

Articolo
03/02/2024

Recupera i metadati relativi a un evento.

Sintassi

TDHSTATUS TdhGetEventInformation(
  [in]      PEVENT_RECORD     Event,
  [in]      ULONG             TdhContextCount,
  [in]      PTDH_CONTEXT      TdhContext,
  [out]     PTRACE_EVENT_INFO Buffer,
  [in, out] PULONG            BufferSize
);

Parametri

[in] Event

Record di evento passato al callback EventRecordCallback . Per informazioni dettagliate, vedere la struttura EVENT_RECORD .

[in] TdhContextCount

Numero di elementi in pTdhContext.

[in] TdhContext

Matrice di valori di contesto solo per gli eventi WPP o ETW classici; in caso contrario, NULL. Per informazioni dettagliate, vedere la struttura TDH_CONTEXT . La matrice non deve contenere tipi di contesto duplicati.

[out] Buffer

Buffer allocato dall'utente per ricevere le informazioni sull'evento. Per informazioni dettagliate, vedere la struttura TRACE_EVENT_INFO .

[in, out] BufferSize

Dimensioni, in byte, del buffer pBuffer . Se la funzione ha esito positivo, questo parametro riceve le dimensioni del buffer usato. Se il buffer è troppo piccolo, la funzione restituisce ERROR_INSUFFICIENT_BUFFER e imposta questo parametro sulla dimensione del buffer necessaria. Se la dimensione del buffer è zero in input, nessun dato viene restituito nel buffer e questo parametro riceve le dimensioni del buffer necessarie.

Valore restituito

Restituisce ERROR_SUCCESS se riuscito. In caso contrario, questa funzione restituisce uno dei codici restituiti seguenti oltre ad altri.

Codice restituito	Descrizione
ERROR_INSUFFICIENT_BUFFER	Le dimensioni del buffer pBuffer sono troppo piccole. Usare il set di dimensioni del buffer richiesto in pBufferSize per allocare un nuovo buffer.
ERROR_NOT_FOUND	Lo schema per l'evento non è stato trovato.
ERROR_INVALID_PARAMETER	Uno o più parametri non sono validi.
ERROR_FILE_NOT_FOUND	L'attributo resourceFileName nel manifesto contiene il percorso del file binario del provider. Quando si registra il manifesto, il percorso viene scritto nel Registro di sistema. TDH non è riuscito a trovare il file binario in base alla posizione registrata.
ERROR_WMI_SERVER_UNAVAILABLE	Il servizio WMI non è disponibile.

Commenti

Se l'evento è un evento WPP o legacy ETW, è possibile specificare le informazioni di contesto usate per analizzare le informazioni sull'evento. L'evento è un evento WPP se il flag di EVENT_HEADER_FLAG_TRACE_MESSAGE è impostato nel membro Flags di EVENT_HEADER (vedere il membro EventHeader di EVENT_RECORD). L'evento è un evento ETW legacy se il flag di EVENT_HEADER_FLAG_CLASSIC_HEADER è impostato.

Esempio

Per un esempio che illustra come recuperare i metadati di un evento, vedere Uso di TdhFormatProperty per l'utilizzo dei dati degli eventi.

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	tdh.h
Libreria	Tdh.lib
DLL	Tdh.dll

Vedi anche

TdhGetEventMapInformation

TdhGetProperty

Condividi tramite