TdhLoadManifest-Funktion (tdh.h)

  • Artikel

Lädt das Manifest, das zum Decodieren einer Protokolldatei verwendet wird.

Syntax

TDHSTATUS TdhLoadManifest(
  [in] PWSTR Manifest
);

Parameter

[in] Manifest

Der vollständige Pfad zum Manifest.

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_FILE_NOT_FOUND
 Die Manifestdatei wurde im angegebenen Pfad nicht gefunden.
ERROR_INVALID_PARAMETER
 Der Manifest-Parameter darf nicht NULL sein, und der Pfad darf MAX_PATH nicht überschreiten.
ERROR_XML_PARSE_ERROR
 Das Manifest hat die Überprüfung nicht bestanden. Um die Validierungsfehler zu ermitteln, führen Sie das Manifest über den Nachrichtencompiler (mc.exe) aus.

Hinweise

Zum Nutzen von Ereignissen benötigt TDH das Manifest des Anbieters. In der Regel decodieren Sie die Protokolldatei auf einem Computer, der den Anbieter enthält. Da der Anbieter das Manifest als Ressource enthält, verwendet TDH den Anbieter, um das Manifest abzurufen. Um die Protokolldatei auf einem Computer zu decodieren, der den Anbieter nicht enthält, müssen Sie zuerst die ausführbare TraceRpt.exe verwenden, um das Manifest (siehe den Schalter –export) aus dem Anbieter auf einem Computer zu exportieren, der den Anbieter enthält. Nachdem Sie über die Manifestdatei verfügen, können Sie die Protokolldatei auf einem Computer decodieren, der den Anbieter nicht enthält.

Sie müssen diese Funktion aufrufen, bevor Sie das erste Ereignis decodieren. Beispielsweise können Sie diese Funktion aufrufen, bevor Sie die OpenTrace-Funktion aufrufen. Rufen Sie nach der Verarbeitung aller Ereignisse die TdhUnloadManifest-Funktion auf.

Anforderungen

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

Weitere Informationen

TdhUnloadManifest