Metodo IDebugClient4::WriteDumpFileWide (dbgeng.h)

Articolo
02/06/2025

Il metodo WriteDumpFileWide crea un file 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 di dump da creare. fileName deve includere l'estensione del nome file. NomeFile 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 invece utilizzato 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 minidumps in modalità utente--quali informazioni 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 ha avuto esito positivo.

Osservazioni

Per altre informazioni sui file di dump di arresto anomalo del sistema, vedere Dump-File Destinazioni.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	dbgeng.h (include Dbgeng.h)

Vedere anche

dump (crea file di dump)

IDebugClient4

IDebugClient5

WriteDumpFile2

Condividi tramite