IDebugClient5::WriteDumpFileWide-Methode (dbgeng.h)

  • Artikel

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
S_OK
 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)

Weitere Informationen

.dump (Speicherabbilddatei erstellen)

IDebugClient4

IDebugClient5

WriteDumpFile2