IDebugClient8::OpenDumpFileWide2-Methode (dbgeng.h)
Die OpenDumpFileWide2--Methode öffnet eine Speicherabbilddatei 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 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.
[in] AlternateArch
Gibt das AlternateArch-Argument an, bei dem es sich um eine IMAGE_FILE_MACHINE_*-Konstante handelt. Weitere Informationen finden Sie unter Image File Machine Constants.
Diese beiden Konstanten werden unterstützt.
IMAGE_FILE_MACHINE_AMD64: Laden als ob das Bild 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 Bilddatei (keine Dumpdatei) zu öffnen, die unterschiedlichen Architekturen zugeordnet werden kann. Beispielsweise ARM64X, wo die DLL in einen x64/EC-Prozess oder einen ARM64-Prozess geladen werden kann.
Standardmäßig werden Informationen über die DLL mithilfe der Architektur dargestellt, die die Bildheader definiert haben. Wenn Sie OpenDumpFileWide2 mit einer anderen Architektur aufrufen, werden die Informationen mithilfe der architektur dargestellt, die übergeben wurde. Auf diese Weise können Sie die "Fixups" sehen, die das Betriebssystem angewendet hätte, wenn die DLL in diese Architektur des Prozesses geladen wurde.
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.
Bemerkungen
Das Modul fügt nicht vollständig an die Speicherabbilddatei an, bis 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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Header- | dbgeng.h (include Dbgeng.h) |