Metodo IDebugClient2::WriteDumpFile2 (dbgeng.h)

Articolo
02/25/2024

Il metodo WriteDumpFile2 crea un file di 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 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 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 la sezione 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 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 è stato eseguito correttamente.

Commenti

I flag di bit DEBUG_FORMAT_XXX 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 il pacchetto del file di dump di arresto anomalo del sistema in un file CAB. Il nome file o l'handle di file fornito viene utilizzato 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 scaricate. 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 più efficiente la compressione del Minidump e aumentare la privacy rimuovendo le 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 private di memoria di lettura/scrittura di cui è stato eseguito il commit.
DEBUG_FORMAT_USER_SMALL_NO_OPTIONAL_DATA	Impedisci 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, che includono l'ora di esecuzione, l'ora di inizio, l'ora di uscita, l'indirizzo di inizio e lo stato di uscita.
DEBUG_FORMAT_USER_SMALL_CODE_SEGMENTS	Aggiungere tutti i segmenti di codice con le immagini eseguibili.

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.