Metodo IDebugClient5::OpenDumpFileWide (dbgeng.h)

Articolo
02/23/2024

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

Sintassi

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

Parametri

[in, optional] FileName

Specifica il nome del file 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. FileName 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 con estensione 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 dump. In caso contrario, se FileName non è NULL, il motore lo restituisce quando viene eseguita una query per il nome del file 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 è stato eseguito correttamente.

Commenti

La versione ASCII di questo metodo è OpenDumpFile.

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.