CreateMergedTraceFile
Diese Funktion führt mehrere Ablaufverfolgungsdateien in einer einzelne Ausgabedatei zusammen.
ULONG
WINAPI
CreateMergedTraceFile(
__in LPCWSTR wszMergedFileName,
__in LPCWSTR wszTraceFileNames[],
__in ULONG cTraceFileNames,
__in DWORD dwExtendedDataFlags
);
Parameter
wszMergedFileName [in]
Gibt den Namen der Ausgabedatei an.
wszTraceFileNames [in]
Zeiger auf ein Array von Ablaufverfolgungsdateien, die zusammengeführt werden sollen.
cTraceFileNames [in]
Anzahl der Elemente im wszTraceFileNames-Array.
dwExtendedDataFlags [in]
Diese Flags geben die Systeminformationen an, die in die zusammengeführte Ablaufverfolgungsdatei eingefügt werden sollen. Weitere Informationen zu gültigen Flags finden Sie unter Benutzerdefiniertes Einfügen von Systeminformationen.
Rückgabewert
ERROR_SUCCESS zeigt Erfolg an.
Mögliche Fehlerwerte sind in der folgenden Tabelle beschrieben.
| Fehlerwert | Beschreibung |
|---|---|
ERROR_INSUFFICIENT_BUFFER |
Gibt möglicherweise an, dass die zusammengeführte Ablaufverfolgung keinen vollständigen Satz von Ereignissen aus jeder Datei enthält. |
ERROR_REVISION_MISMATCH |
Gibt möglicherweise an, dass die zusammengeführten Ablaufverfolgungsdateien Ereignisse mit verschiedenen Versionen enthalten, die nicht zusammengeführt werden konnten. |
Wenn keiner dieser Fehlerwerte zurückgegeben wird, wird ein Systemfehlercode zurückgegeben.
Bemerkungen
Sie können zwei oder mehrere Ablaufverfolgungsdateien aus gleichzeitigen Sitzungen, die auf demselben Computer erfasst wurden, in einer einzigen Ablaufverfolgungsdatei zusammenführen. Sie können auch Ablaufverfolgungsdateien aus anderen Ablaufverfolgungssitzungen zusammenführen, wenn diese Dateien dieselben Startzeiten haben. Optional fügt der Zusammenführungsvorgang Metadaten zu den Ablaufverfolgungen hinzu.
Diese Funktion kann erweiterte Daten in eine einzige Ablaufverfolgungsdatei einfügen. In diesem Fall enthält das wszMergedFileName-Array nur ein einzelnes Element, das der Namen der Ablaufverfolgungsdatei ist.
Hinweis Eine nicht zusammengeführte Kernelablaufverfolgung kann keine Symbole ordnungsgemäß codieren.
Die API ist nur in Unicode implementiert.
Anforderungen
Versionen: Verfügbar ab Windows Vista. Diese Struktur wird über Windows Performance Analyzer bereitgestellt.
Header: In „KernelTraceControl.h“ deklariert. „KernelTraceControl.h“ einschließen.
Bibliothek: In „KernelTraceControl.dll“ enthalten.