Metodo IDebugClient5::WriteDumpFile2 (dbgeng.h)

Articolo
02/06/2025

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

Sintassi

HRESULT WriteDumpFile2(
  [in]           PCSTR DumpFile,
  [in]           ULONG Qualifier,
  [in]           ULONG FormatFlags,
  [in, optional] PCSTR Comment
);

Parametri

[in] DumpFile

Specifica il nome del file di dump da creare. 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.

[in] Qualifier

Specifica il tipo di file 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 Osservazioni.

[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. Alcuni formati di file di dump non supportano l'archiviazione di stringhe di commento.

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

I DEBUG_FORMAT_XXX flag di bit vengono usati da WriteDumpFile2 e WriteDumpFileWide per determinare il formato di un file di dump di arresto anomalo del sistema e, per minidump in modalità utente, quali informazioni includere nel file.

I flag di bit seguenti si applicano a tutti i file di dump di arresto anomalo del sistema.

Valore	Descrizione
DEBUG_FORMAT_WRITE_CAB	Creare un pacchetto del file dump di arresto anomalo del sistema in un file CAB. Il nome file o l'handle di file fornito viene usato per il file CAB; il dump di arresto anomalo del sistema viene creato prima di essere spostato nel file CAB.
DEBUG_FORMAT_CAB_SECONDARY_FILES	Includere i simboli correnti e le immagini mappate nel file CAB. Se DEBUG_FORMAT_WRITE_CAB non è impostato, questo flag viene ignorato.
DEBUG_FORMAT_NO_OVERWRITE	Non sovrascrivere i file esistenti.

I flag di bit seguenti possono essere inclusi anche per minidump in modalità utente.

Valore	Descrizione
DEBUG_FORMAT_USER_SMALL_FULL_MEMORY	Aggiungere dati di memoria completi. Verranno incluse tutte le pagine di cui è stato eseguito il commit accessibile di proprietà dell'applicazione di destinazione.
DEBUG_FORMAT_USER_SMALL_HANDLE_DATA	Aggiungere dati sugli handle associati all'applicazione di destinazione.
DEBUG_FORMAT_USER_SMALL_UNLOADED_MODULES	Aggiungere informazioni sul modulo scaricato. Queste informazioni sono disponibili solo in Windows Server 2003 e versioni successive di Windows.
DEBUG_FORMAT_USER_SMALL_INDIRECT_MEMORY	Aggiungere memoria indiretta. È inclusa una piccola area di memoria che circonda qualsiasi indirizzo a cui fa riferimento un puntatore nello stack o nell'archivio di backup.
DEBUG_FORMAT_USER_SMALL_DATA_SEGMENTS	Aggiungere tutti i segmenti di dati all'interno delle immagini eseguibili.
DEBUG_FORMAT_USER_SMALL_FILTER_MEMORY	Impostare su zero tutta la memoria nello stack e nell'archivio di backup che non è utile per ricreare l'analisi dello stack. Ciò può rendere la compressione del Minidump più efficiente e aumentare la privacy rimuovendo informazioni non necessarie.
DEBUG_FORMAT_USER_SMALL_FILTER_PATHS	Rimuovere i percorsi del modulo, lasciando solo i nomi dei moduli. Ciò è utile per proteggere la privacy nascondendo la struttura di directory (che può contenere il nome dell'utente).
DEBUG_FORMAT_USER_SMALL_PROCESS_THREAD_DATA	Aggiungere il blocco di ambiente del processo (PEB) e il blocco di ambiente thread (TEB). Questo flag può essere usato per fornire informazioni di sistema windows per thread e processi.
DEBUG_FORMAT_USER_SMALL_PRIVATE_READ_WRITE_MEMORY	Aggiungere tutte le pagine di memoria di lettura/scrittura private di cui è stato eseguito il commit.
DEBUG_FORMAT_USER_SMALL_NO_OPTIONAL_DATA	Impedire l'inserimento di dati sensibili alla privacy nel Minidump. Attualmente, questo flag esclude dai dati minidump che sarebbero stati aggiunti a causa dei flag seguenti impostati: DEBUG_FORMAT_USER_SMALL_PROCESS_THREAD_DATA, DEBUG_FORMAT_USER_SMALL_FULL_MEMORY, DEBUG_FORMAT_USER_SMALL_INDIRECT_MEMORY, DEBUG_FORMAT_USER_SMALL_PRIVATE_READ_WRITE_MEMORY.
DEBUG_FORMAT_USER_SMALL_FULL_MEMORY_INFO	Aggiungere tutte le informazioni di base sulla memoria. Si tratta delle informazioni restituite dal metodo QueryVirtual. Le informazioni per tutta la memoria sono incluse, non solo la memoria valida, che consente al debugger di ricostruire il layout completo della memoria virtuale da Minidump.
DEBUG_FORMAT_USER_SMALL_THREAD_INFO	Aggiungere informazioni aggiuntive sul thread, tra cui ora di esecuzione, ora di inizio, ora di uscita, indirizzo di inizio e stato di uscita.
DEBUG_FORMAT_USER_SMALL_CODE_SEGMENTS	Aggiungere tutti i segmenti di codice con le immagini eseguibili.