Metodo IDebugClient5::WriteDumpFileWide (dbgeng.h)

Articolo
02/25/2024

Il metodo WriteDumpFileWide crea un file di dump in modalità utente o kernel-modecrash.

Sintassi

HRESULT WriteDumpFileWide(
  [in, optional] PCWSTR  FileName,
  [in]           ULONG64 FileHandle,
  [in]           ULONG   Qualifier,
  [in]           ULONG   FormatFlags,
  [in, optional] PCWSTR  Comment
);

Parametri

[in, optional] FileName

Specifica il nome del file dump da creare. 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. Se FileHandle non è NULL, FileName viene ignorato (tranne quando si scrivono messaggi di stato nella console del debugger).

[in] FileHandle

Specifica l'handle di file del file in cui scrivere il dump di arresto anomalo del sistema. Se FileHandle è NULL, viene usato invece il file specificato in FileName .

[in] Qualifier

Specifica il tipo di dump da creare. Per i valori possibili, vedere DEBUG_DUMP_XXX.

[in] FormatFlags

Specifica i flag che determinano il formato del file di dump e, per i minidumps in modalità utente, le informazioni da includere nel file. Per informazioni dettagliate, vedere DEBUG_FORMAT_XXX.

[in, optional] Comment

Specifica una stringa di commento da includere nel file di dump di arresto anomalo del sistema. Questa stringa viene visualizzata nella console del debugger quando viene caricato il file dump.

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

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.