Metodo IDebugClient5::OpenDumpFile (dbgeng.h)

Articolo
02/06/2025

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 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, 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 ha avuto esito positivo.

Osservazioni

La versione Unicode di questo metodo è OpenDumpFileWide.

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.