IDebugClient3::OpenDumpFile-Methode (dbgeng.h)

Artikel
02/23/2024

Die OpenDumpFile-Methode öffnet eine Speicherabbilddatei als Debuggerziel.

Syntax

HRESULT OpenDumpFile(
  [in] PCSTR DumpFile
);

Parameter

[in] DumpFile

Gibt den Namen der zu öffnenden Speicherabbilddatei 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 in der Cabinet-Datei nach der ersten Datei mit der Erweiterung .kdmp, dann .hdmp, dann .mdmp und schließlich nach .dmp gesucht.

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

Die Unicode-Version dieser Methode ist OpenDumpFileWide.

Hinweis Die Engine fügt nicht vollständig an die Speicherabbilddatei an, bis die WaitForEvent-Methode aufgerufen wurde. Wenn eine Speicherabbilddatei aus einem Prozess oder Kernel erstellt wird, werden Informationen zum letzten Ereignis in der Speicherabbilddatei gespeichert. Nachdem die Speicherabbilddatei geöffnet wurde, generiert die Engine bei der nächsten Ausführung dieses Ereignis für die Ereignisrückrufe. Erst dann wird die Speicherabbilddatei in der Debugsitzung verfügbar.

Weitere Informationen zu Absturzabbilddateien finden Sie unter Speicherabbilddateiziele.