Metodo IDebugClient5::OpenDumpFileWide (dbgeng.h)

Articolo
02/06/2025

Il metodo OpenDumpFileWide apre un file dump come destinazione del debugger.

Sintassi

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

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.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.

Osservazioni

La versione ASCII di questo metodo è OpenDumpFile.

Nota Il motore non si collega completamente al file di 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.