Metode IDebugClient5::WriteDumpFile2 (dbgeng.h)

Artikel
08/07/2023

Metode WriteDumpFile2 membuat mode pengguna atau file cadangan kernel-modecrash.

Sintaks

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

Parameter

[in] DumpFile

Menentukan nama file cadangan yang akan dibuat. DumpFile harus menyertakan ekstensi nama file. DumpFile dapat mencakup jalur relatif atau absolut; jalur relatif relatif terhadap direktori tempat debugger dimulai.

[in] Qualifier

Menentukan jenis file cadangan yang akan dibuat. Untuk nilai yang mungkin, lihat DEBUG_DUMP_XXX.

[in] FormatFlags

Menentukan bendera yang menentukan format file cadangan dan--untuk minidumps mode pengguna--informasi apa yang akan disertakan dalam file. Untuk detailnya, lihat Keterangan.

[in, optional] Comment

Menentukan string komentar yang akan disertakan dalam file crash dump. String ini ditampilkan di konsol debugger saat file cadangan dimuat. Beberapa format file cadangan tidak mendukung penyimpanan string komentar.

Nilai kembali

Metode ini juga dapat mengembalikan nilai kesalahan. Lihat Mengembalikan Nilai untuk detail selengkapnya.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

Bendera bit DEBUG_FORMAT_XXX digunakan oleh WriteDumpFile2 dan WriteDumpFileWide untuk menentukan format file crash dump dan, untuk Minidump mode pengguna, informasi apa yang akan disertakan dalam file.

Bendera bit berikut berlaku untuk semua file crash dump.

Nilai	Deskripsi
DEBUG_FORMAT_WRITE_CAB	Kemas file crash dump dalam file CAB. Nama file atau handel file yang disediakan digunakan untuk file CAB; crash dump pertama kali dibuat dalam file sementara sebelum dipindahkan ke file CAB.
DEBUG_FORMAT_CAB_SECONDARY_FILES	Sertakan simbol saat ini dan gambar yang dipetakan dalam file CAB. Jika DEBUG_FORMAT_WRITE_CAB tidak diatur, bendera ini diabaikan.
DEBUG_FORMAT_NO_OVERWRITE	Jangan timpa berkas yang ada.

Bendera bit berikut juga dapat disertakan untuk Minidumps mode pengguna.

Nilai	Deskripsi
DEBUG_FORMAT_USER_SMALL_FULL_MEMORY	Tambahkan data memori penuh. Semua halaman berkomitmen yang dapat diakses yang dimiliki oleh aplikasi target akan disertakan.
DEBUG_FORMAT_USER_SMALL_HANDLE_DATA	Tambahkan data tentang handel yang terkait dengan aplikasi target.
DEBUG_FORMAT_USER_SMALL_UNLOADED_MODULES	Tambahkan informasi modul yang dibongkar. Informasi ini hanya tersedia di Windows Server 2003 dan versi Windows yang lebih baru.
DEBUG_FORMAT_USER_SMALL_INDIRECT_MEMORY	Tambahkan memori tidak langsung. Wilayah kecil memori yang mengelilingi alamat apa pun yang dirujuk oleh penunjuk pada tumpukan atau penyimpanan cadangan disertakan.
DEBUG_FORMAT_USER_SMALL_DATA_SEGMENTS	Tambahkan semua segmen data dalam gambar yang dapat dieksekusi.
DEBUG_FORMAT_USER_SMALL_FILTER_MEMORY	Atur ke nol semua memori pada tumpukan dan di penyimpanan cadangan yang tidak berguna untuk membuat ulang jejak tumpukan. Ini dapat membuat pemadatan Minidump lebih efisien dan meningkatkan privasi dengan menghapus informasi yang tidak perlu.
DEBUG_FORMAT_USER_SMALL_FILTER_PATHS	Hapus jalur modul, hanya menyisakan nama modul. Ini berguna untuk melindungi privasi dengan menyembunyikan struktur direktori (yang mungkin berisi nama pengguna).
DEBUG_FORMAT_USER_SMALL_PROCESS_THREAD_DATA	Tambahkan blok lingkungan proses (PEB) dan blok lingkungan utas (TEB). Bendera ini dapat digunakan untuk memberikan informasi sistem Windows untuk utas dan proses.
DEBUG_FORMAT_USER_SMALL_PRIVATE_READ_WRITE_MEMORY	Tambahkan semua halaman memori baca-tulis privat yang diterapkan.
DEBUG_FORMAT_USER_SMALL_NO_OPTIONAL_DATA	Mencegah data sensitif privasi disertakan dalam Minidump. Saat ini, bendera ini mengecualikan dari data Minidump yang akan ditambahkan karena bendera berikut diatur: 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	Tambahkan semua informasi memori dasar. Ini adalah informasi yang dikembalikan oleh metode QueryVirtual . Informasi untuk semua memori disertakan, bukan hanya memori yang valid, yang memungkinkan debugger merekonstruksi tata letak memori virtual lengkap dari Minidump.
DEBUG_FORMAT_USER_SMALL_THREAD_INFO	Tambahkan informasi utas tambahan, yang mencakup waktu eksekusi, waktu mulai, waktu keluar, alamat mulai, dan status keluar.
DEBUG_FORMAT_USER_SMALL_CODE_SEGMENTS	Tambahkan semua segmen kode dengan gambar yang dapat dieksekusi.