IDebugClient4::OpenDumpFileWide-Methode (dbgeng.h)

2025-02-06

Die OpenDumpFileWide--Methode öffnet eine Speicherabbilddatei als Debuggerziel.

Syntax

HRESULT OpenDumpFileWide(
  [in, optional] PCWSTR  FileName,
  [in]           ULONG64 FileHandle
);

Parameter

[in, optional] FileName

Gibt den Namen der zu öffnenden Speicherabbilddatei an. Es sei denn, FileHandle- ist null, in diesem Fall wird FileName- nur verwendet, wenn das Modul nach dem Namen der Dumpdatei abgefragt wird. 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. FileName- kann sich auch in Form einer Datei-URL befinden, beginnend mit "file://". Wenn FileName- 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.

[in] FileHandle

Gibt das Dateihandle der zu öffnenden Speicherabbilddatei an. Wenn FileHandle- null ist, wird FileName- verwendet, um die Speicherabbilddatei zu öffnen. Andernfalls gibt das Modul, wenn FileName- nicht NULL-ist, wenn es beim Abfragen nach dem Namen der Speicherabbilddatei zurückgegeben wird. Wenn FileHandle- nicht null ist und FileName-NULL-ist, gibt das Modul HandleOnly- für den Dateinamen zurück.

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 ASCII-Version dieser Methode ist OpenDumpFile-.

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.