IDebugClient8::OpenDumpFileWide2-Methode (dbgeng.h)
Die OpenDumpFileWide2-Methode öffnet eine Dumpdatei als Debuggerziel.
Syntax
HRESULT OpenDumpFileWide2(
[in, optional] PCWSTR FileName,
[in] ULONG64 FileHandle,
[in] ULONG AlternateArch
);
Parameter
[in, optional] FileName
Gibt den Namen der zu öffnenden Dumpdatei an, es sei denn , FileHandle ist nicht 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 auch in Form einer Datei-URL sein, beginnend mit "file://". Wenn FileName eine Ablagedatei (.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.
[in] FileHandle
Gibt das Dateihandle der zu öffnenden Dumpdatei an. Wenn FileHandle null ist, wird FileName verwendet, um die Dumpdatei zu öffnen. Andernfalls gibt das Modul, wenn FileName nicht NULL ist, zurück, wenn es nach dem Namen der Dumpdatei abgefragt wird. Wenn FileHandle nicht null und FileNameNULL ist, gibt das Modul HandleOnly für den Dateinamen zurück.
[in] AlternateArch
Gibt das AlternateArch-Argument an, das eine IMAGE_FILE_MACHINE_*-Konstante ist. Weitere Informationen finden Sie unter ImageDateicomputerkonstanten.
Diese beiden Konstanten werden unterstützt.
IMAGE_FILE_MACHINE_AMD64: Laden, als ob das Image in einem x64-Prozess ausgeführt wird
IMAGE_FILE_MACHINE_ARM64: Laden, als ob das Image in einem ARM64-Prozess ausgeführt wird
Dieser Parameter ist nur relevant, wenn Sie OpenDumpFileWide2 verwenden, um eine Imagedatei (keine Dumpdatei) zu öffnen, die verschiedenen Architekturen zugeordnet werden kann. Beispiel: ARM64X, bei dem die DLL in einen x64/EC-Prozess oder einen ARM64-Prozess geladen werden kann.
Standardmäßig werden Informationen zur DLL unter Verwendung der von den Bildheadern definierten Architektur angezeigt. Wenn Sie OpenDumpFileWide2 mit einer anderen Architektur aufrufen, werden die Informationen mithilfe der übergebenen Architektur angezeigt. Dadurch können Sie die "Fixups" anzeigen, die das Betriebssystem angewendet hätte, wenn die DLL in diese Architektur des Prozesses geladen worden wäre.
Weitere Informationen zu ARM64X finden Sie unter Arm64X PE-Dateien.
Rückgabewert
Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .
Hinweise
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | dbgeng.h (einschließlich Dbgeng.h) |