Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Il metodo OpenDumpFileWide2 apre un file dump come destinazione del debugger.
Sintassi
HRESULT OpenDumpFileWide2(
[in, optional] PCWSTR FileName,
[in] ULONG64 FileHandle,
[in] ULONG AlternateArch
);
Parametri
[in, optional] FileName
Specifica il nome del file di dump da aprire, a meno che FileHandle non sia zero, nel qual caso fileName viene usato solo quando viene eseguita una query del motore per il nome del file di dump. fileName deve includere l'estensione del nome file. NomeFile può includere un percorso relativo o assoluto; i percorsi relativi sono relativi alla directory in cui è stato avviato il debugger. FileName può anche essere sotto forma di URL di file, a partire da "file://". Se FileName specifica un file cab (.cab) , il file cab viene cercato il primo file con estensione .kdmp, quindi .hdmp, quindi .mdmp e infine .dmp.
[in] FileHandle
Specifica l'handle di file del file dump da aprire. Se fileHandle è zero, fileName viene usato per aprire il file di dump. In caso contrario, se FileName non è NULL, il motore lo restituisce quando viene eseguita una query per il nome del file di dump. Se FileHandle non è zero e fileName è null, il motore restituirà HandleOnly per il nome del file.
[in] AlternateArch
Specifica l'argomento AlternateArch che è una costante IMAGE_FILE_MACHINE_*. Per altre informazioni, vedere costanti di file di immagine.
Queste due costanti sono supportate.
IMAGE_FILE_MACHINE_AMD64: caricare come se l'immagine sia in esecuzione in un processo x64
IMAGE_FILE_MACHINE_ARM64: caricare come se l'immagine sia in esecuzione in un processo ARM64
Questo parametro è rilevante solo se si usa OpenDumpFileWide2 per aprire un file di immagine (non un file di dump) di cui è possibile eseguire il mapping in architetture diverse. Ad esempio ARM64X, dove la DLL può essere caricata in un processo x64/EC o in un processo ARM64.
Per impostazione predefinita, le informazioni sulla DLL vengono presentate usando qualsiasi architettura definita dalle intestazioni dell'immagine. Se si chiama OpenDumpFileWide2 con un'architettura diversa, le informazioni verranno presentate usando l'architettura passata. In questo modo è possibile visualizzare le "correzioni" che il sistema operativo avrebbe applicato se la DLL fosse stata caricata in tale architettura di processo.
Per altre informazioni su ARM64X, vedere file ARM64X PE.
Valore restituito
Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.
Osservazioni
Il motore non è completamente collegato al file dump finché non viene chiamato il metodo WaitForEvent. Quando un file dump viene creato da un processo o da un kernel, le informazioni sull'ultimo evento vengono archiviate nel file di dump. Dopo l'apertura del file di dump, la volta successiva che viene tentata l'esecuzione, il motore genererà questo evento per i callback degli eventi. Solo il file dump diventa disponibile nella sessione di debug.
Per altre informazioni sui file di dump di arresto anomalo del sistema, vedere Dump-File Destinazioni.
Fabbisogno
Requisito | Valore |
---|---|
piattaforma di destinazione | Finestre |
intestazione | dbgeng.h (include Dbgeng.h) |