IDebugClient5::OpenDumpFileWide-Methode (dbgeng.h)

Artikel
02/23/2024

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 nicht null. In diesem Fall wird FileName nur verwendet, wenn die Engine nach dem Namen der Speicherabbilddatei 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 auch in Form einer Datei-URL vorliegen, beginnend mit "file://". Wenn FileName 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.

[in] FileHandle

Gibt das Dateihandle der zu öffnenden Speicherabbilddatei an. Wenn FileHandle null ist, wird FileName verwendet, um die Speicherabbilddatei zu öffnen. Andernfalls gibt die Engine, wenn FileName nicht NULL ist, den Wert zurück, wenn sie nach dem Namen der Speicherabbilddatei abgefragt wird. Wenn FileHandle nicht null und FileNameNULL ist, gibt die Engine HandleOnly für den Dateinamen zurück.

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

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.