Metodo IDebugClient3::WriteDumpFile2 (dbgeng.h)

Articolo
08/07/2023

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 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-what 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. Questa stringa viene visualizzata nella console del debugger quando viene caricato il file dump. Alcuni formati di file di dump non supportano l'archiviazione delle stringhe di commento.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altre informazioni, 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 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.

Valore	Descrizione
DEBUG_FORMAT_WRITE_CAB	Creare un pacchetto del file di dump di arresto anomalo in un file CAB. Per il file CAB viene usato il nome o l'handle di file specificato; il dump dell'arresto anomalo viene prima creato in un file temporaneo 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. Tutte le pagine commit accessibili di proprietà dell'applicazione di destinazione verranno incluse.
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 non caricate. 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 la traccia 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 della 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 privata di lettura con 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 memoria valida, che consente al debugger di ricostruire il layout completo della memoria virtuale dal 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.