TdhGetManifestEventInformation-Funktion (tdh.h)

Artikel
03/13/2024

Die TdhGetManifestEventInformation-Funktion ruft Metadaten zu einem Ereignis in einem Manifest ab.

Syntax

TDHSTATUS TdhGetManifestEventInformation(
  [in]      LPGUID            ProviderGuid,
  [in]      PEVENT_DESCRIPTOR EventDescriptor,
  [out]     PTRACE_EVENT_INFO Buffer,
  [in, out] ULONG             *BufferSize
);

Parameter

[in] ProviderGuid

Eine GUID, die den Manifestanbieter identifiziert, dessen Ereignismetadaten Sie abrufen möchten.

[in] EventDescriptor

Ein Zeiger auf den Ereignisdeskriptor, der Informationen wie Ereignis-ID, Version, Op-Code und Schlüsselwort (keyword) enthält. Weitere Informationen finden Sie in der EVENT_DESCRIPTOR-Struktur .

[out] Buffer

Ein vom Benutzer zugewiesener Puffer zum Empfangen der Metadaten zu einem Ereignis in einem Anbietermanifest. Weitere Informationen finden Sie in der TRACE_EVENT_INFO-Struktur .

[in, out] BufferSize

Die Größe des Puffers in Bytes, auf den der Buffer-Parameter verweist. 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
ERROR_EMPTY	Für die Anbieter-GUID im Manifest sind keine Ereignisse definiert.
ERROR_FILE_NOT_FOUND	Die Metadaten für den Anbieter wurden nicht gefunden.
ERROR_INSUFFICIENT_BUFFER	Die Größe des Puffers, auf den der Buffer-Parameter verweist, ist zu klein. Verwenden Sie die erforderliche Puffergröße, die im BufferSize-Parameter festgelegt ist, um einen neuen Puffer zuzuweisen.
ERROR_INVALID_PARAMETER	Mindestens einer der Parameter ist ungültig.
ERROR_NOT_FOUND	Die Schemainformationen für die angegebene Anbieter-GUID wurden nicht gefunden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	tdh.h
Bibliothek	Tdh.lib
DLL	Tdh.dll

Weitere Informationen

EVENT_DESCRIPTOR

PROVIDER_EVENT_INFO

TRACE_EVENT_INFO

TdhEnumerateManifestProviderEvents

Freigeben über