Metodo IDebugClient5::OpenDumpFile (dbgeng.h)

Articolo
08/07/2023

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

Sintassi

HRESULT OpenDumpFile(
  [in] PCSTR DumpFile
);

Parametri

[in] DumpFile

Specifica il nome del file dump da aprire. DumpFile deve includere l'estensione del nome file. DumpFile può includere un percorso relativo o assoluto; i percorsi relativi sono relativi alla directory in cui è stato avviato il debugger. DumpFile può avere la forma di un URL di file, a partire da "file://". Se DumpFile specifica un file cabinet (.cab), il file cabinet viene cercato per il primo file con estensione .kdmp, quindi .hdmp, .mdmp e infine .dmp.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altre informazioni, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.

Commenti

La versione Unicode di questo metodo è OpenDumpFileWide.

Nota Il motore non è completamente collegato al file dump finché non è stato 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 dump. Dopo l'apertura del file di dump, l'esecuzione successiva viene tentata, il motore genererà questo evento per i callback dell'evento. Solo il file dump diventa disponibile nella sessione di debug.

Per altre informazioni sui file di dump di arresto anomalo, vedere Destinazioni dump-file.