IDebugClient4::OpenDumpFile-Methode (dbgeng.h)

Artikel
02/06/2025

Die OpenDumpFile Methode öffnet eine Speicherabbilddatei als Debuggerziel.

Syntax

HRESULT OpenDumpFile(
  [in] PCSTR DumpFile
);

Parameter

[in] DumpFile

Gibt den Namen der zu öffnenden Dumpdatei an. DumpFile- muss die Dateinamenerweiterung enthalten. DumpFile- kann einen relativen oder absoluten Pfad enthalten; Relative Pfade sind relativ zum Verzeichnis, in dem der Debugger gestartet wurde. DumpFile- kann die Form einer Datei-URL haben, beginnend mit "file://". Wenn DumpFile- eine CAB-Datei (.cab) angibt, wird die CAB-Datei nach der ersten Datei mit der Erweiterung KDMP, dann .hdmp, dann .mdmp und schließlich .dmp gesucht.

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

Die Unicode-Version dieser Methode ist OpenDumpFileWide.

Hinweis Das Modul wird erst vollständig an die Speicherabbilddatei angefügt, wenn die WaitForEvent-Methode aufgerufen wurde. Wenn eine Dumpdatei aus einem Prozess oder Kernel erstellt wird, werden Informationen zum letzten Ereignis in der Speicherabbilddatei gespeichert. Nachdem die Speicherabbilddatei geöffnet wurde, wird beim nächsten Versuch der Ausführung dieses Ereignisses für die Ereignisrückrufe generiert. Erst dann wird die Speicherabbilddatei in der Debugsitzung verfügbar.

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