IDebugClient5::WriteDumpFileWide-Methode (dbgeng.h)
Die WriteDumpFileWide-Methode erstellt eine Speicherabbilddatei im Benutzermodus oder kernel-modecrash.
Syntax
HRESULT WriteDumpFileWide(
[in, optional] PCWSTR FileName,
[in] ULONG64 FileHandle,
[in] ULONG Qualifier,
[in] ULONG FormatFlags,
[in, optional] PCWSTR Comment
);
Parameter
[in, optional] FileName
Gibt den Namen der zu erstellenden Speicherabbilddatei an. FileName muss die Dateinamenerweiterung enthalten. FileName kann einen relativen oder absoluten Pfad enthalten. relative Pfade sind relativ zum Verzeichnis, in dem der Debugger gestartet wurde. Wenn FileHandle nicht NULL ist, wird FileName ignoriert (außer beim Schreiben status Nachrichten in die Debuggerkonsole).
[in] FileHandle
Gibt das Dateihandle der Datei an, in die das Absturzabbild geschrieben werden soll. Wenn FileHandleNULL ist, wird stattdessen die in FileName angegebene Datei verwendet.
[in] Qualifier
Gibt den Typ des zu erstellenden Speicherabbilds an. Mögliche Werte finden Sie unter DEBUG_DUMP_XXX.
[in] FormatFlags
Gibt Flags an, die das Format der Speicherabbilddatei bestimmen, und – für Minidumps im Benutzermodus – welche Informationen in die Datei aufgenommen werden sollen. Weitere Informationen finden Sie unter DEBUG_FORMAT_XXX.
[in, optional] Comment
Gibt eine Kommentarzeichenfolge an, die in die Absturzabbilddatei eingeschlossen werden soll. Diese Zeichenfolge wird in der Debuggerkonsole angezeigt, wenn die Speicherabbilddatei geladen wird.
Rückgabewert
Diese Methode gibt möglicherweise auch Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode war erfolgreich. |
Hinweise
Weitere Informationen zu Absturzabbilddateien finden Sie unter Speicherabbilddateiziele.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | dbgeng.h (dbgeng.h einschließen) |