Metodo IDebugClient3::OpenDumpFile (dbgeng.h)

Articolo
02/26/2024

Il metodo OpenDumpFile apre un file di 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 il formato di un URL di file, a partire da "file://". Se DumpFile specifica un file cab (.cab), il file cab viene cercato per il primo file con estensione kdmp, quindi con estensione hdmp, quindi con estensione mdmp e infine .dmp.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, 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 viene chiamato il metodo WaitForEvent . Quando un file di 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 dell'evento. 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 Targets.For more information about crash dump dump files, see Dump-File Targets.