TdhGetEventInformation-Funktion (tdh.h)
Ruft Metadaten zu einem Ereignis ab.
Syntax
TDHSTATUS TdhGetEventInformation(
[in] PEVENT_RECORD Event,
[in] ULONG TdhContextCount,
[in] PTDH_CONTEXT TdhContext,
[out] PTRACE_EVENT_INFO Buffer,
[in, out] PULONG BufferSize
);
Parameter
[in] Event
Der an Ihren EventRecordCallback-Rückruf übergebene Ereignisdatensatz. Weitere Informationen finden Sie in der EVENT_RECORD-Struktur .
[in] TdhContextCount
Anzahl der Elemente in pTdhContext.
[in] TdhContext
Array von Kontextwerten nur für WPP- oder klassische ETW-Ereignisse; andernfalls NULL. Weitere Informationen finden Sie in der TDH_CONTEXT-Struktur . Das Array darf keine doppelten Kontexttypen enthalten.
[out] Buffer
Vom Benutzer zugewiesener Puffer zum Empfangen der Ereignisinformationen. Weitere Informationen finden Sie in der TRACE_EVENT_INFO-Struktur .
[in, out] BufferSize
Größe des pBuffer-Puffers in Bytes. Wenn die Funktion erfolgreich ist, empfängt dieser Parameter die Größe des verwendeten Puffers. Wenn der Puffer zu klein ist, gibt die Funktion ERROR_INSUFFICIENT_BUFFER zurück und legt diesen Parameter auf die erforderliche Puffergröße fest. Wenn die Puffergröße bei der Eingabe null ist, werden keine Daten im Puffer zurückgegeben, und dieser Parameter empfängt die erforderliche Puffergröße.
Rückgabewert
Gibt bei erfolgreicher Ausführung ERROR_SUCCESS zurück. Andernfalls gibt diese Funktion zusätzlich zu anderen einen der folgenden Rückgabecodes zurück.
Rückgabecode | Beschreibung |
---|---|
|
Die Größe des pBuffer-Puffers ist zu klein. Verwenden Sie die erforderliche Puffergröße, die in pBufferSize festgelegt ist, um einen neuen Puffer zuzuweisen. |
|
Das Schema für das Ereignis wurde nicht gefunden. |
|
Mindestens einer der Parameter ist ungültig. |
|
Das resourceFileName-Attribut im Manifest enthält den Speicherort der Anbieterbinärdatei. Wenn Sie das Manifest registrieren, wird der Speicherort in die Registrierung geschrieben. TDH konnte die Binärdatei basierend auf dem registrierten Speicherort nicht finden. |
|
Der WMI-Dienst ist nicht verfügbar. |
Hinweise
Wenn es sich bei dem Ereignis um ein WPP- oder Legacy-ETW-Ereignis handelt, können Sie Kontextinformationen angeben, die zum Analysieren der Ereignisinformationen verwendet werden. Das Ereignis ist ein WPP-Ereignis, wenn das EVENT_HEADER_FLAG_TRACE_MESSAGE-Flag im Flags-Member von EVENT_HEADER festgelegt ist (siehe EventHeader-Member von EVENT_RECORD). Das Ereignis ist ein ETW-Legacyereignis, wenn das flag EVENT_HEADER_FLAG_CLASSIC_HEADER festgelegt ist.
Beispiele
Ein Beispiel zum Abrufen von Metadaten zu einem Ereignis finden Sie unter Verwenden von TdhFormatProperty zum Nutzen von Ereignisdaten.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | tdh.h |
Bibliothek | Tdh.lib |
DLL | Tdh.dll |