IDebugClient::OpenDumpFile-Methode (dbgeng.h)

Artikel
02/23/2024

Die OpenDumpFile-Methode öffnet eine Dumpdatei 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 Cabinet-Datei (.cab) angibt, wird die Kabinettdatei nach der ersten Datei mit der Erweiterung .kdmp, dann nach .hdmp, dann nach .mdmp und schließlich nach .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.

Hinweise

Die Unicode-Version dieser Methode ist OpenDumpFileWide.

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

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