TdhLoadManifest-Funktion (tdh.h)
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 |
|---|---|
|
Die Manifestdatei wurde im angegebenen Pfad nicht gefunden. |
|
Der Manifest-Parameter darf nicht NULL sein, und der Pfad darf MAX_PATH nicht überschreiten. |
|
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 |