IDebugClient4::WriteDumpFileWide-Methode (dbgeng.h)

Artikel
02/06/2025

Die WriteDumpFileWide--Methode erstellt eine Benutzermodus- oder Kernelmoduscrash-Dumpdatei.

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 Dumpdatei 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 von Statusmeldungen in die Debuggerkonsole).

[in] FileHandle

Gibt das Dateihandle der Datei an, in das das Absturzabbild geschrieben werden soll. Wenn FileHandle-NULL-ist, wird stattdessen die in FileName angegebene Datei verwendet.

[in] Qualifier

Gibt den Typ des zu erstellenden Dumps an. Mögliche Werte finden Sie unter DEBUG_DUMP_XXX.

[in] FormatFlags

Gibt Flags an, die das Format der Speicherabbilddatei und -für den Benutzermodus-Minidumps bestimmen, welche Informationen in die Datei eingeschlossen werden sollen. Ausführliche Informationen finden Sie unter DEBUG_FORMAT_XXX.

[in, optional] Comment

Gibt eine Kommentarzeichenfolge an, die in die Absturzabbilddatei aufgenommen werden soll. Diese Zeichenfolge wird in der Debuggerkonsole angezeigt, wenn die Speicherabbilddatei geladen wird.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.

Bemerkungen

Weitere Informationen zu Absturzabbilddateien finden Sie unter Dump-File Targets.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include Dbgeng.h)

Siehe auch

.dump (Create Dump File)

IDebugClient4-

IDebugClient5-

WriteDumpFile2-

Freigeben über