struktur WER_DUMP_CUSTOM_OPTIONS (werapi.h)

Menentukan informasi minidump Pelaporan Galat Windows kustom (WER) yang akan dikumpulkan oleh fungsi WerReportAddDump.

Sintaks

typedef struct _WER_DUMP_CUSTOM_OPTIONS {
  DWORD dwSize;
  DWORD dwMask;
  DWORD dwDumpFlags;
  BOOL  bOnlyThisThread;
  DWORD dwExceptionThreadFlags;
  DWORD dwOtherThreadFlags;
  DWORD dwExceptionThreadExFlags;
  DWORD dwOtherThreadExFlags;
  DWORD dwPreferredModuleFlags;
  DWORD dwOtherModuleFlags;
  WCHAR wzPreferredModuleList[WER_MAX_PREFERRED_MODULES_BUFFER];
} WER_DUMP_CUSTOM_OPTIONS, *PWER_DUMP_CUSTOM_OPTIONS;

Anggota

dwSize

Ukuran struktur, dalam byte.

dwMask

Masker yang mengontrol opsi mana yang valid dalam struktur ini. Anda bisa menentukan satu atau beberapa nilai berikut ini:

• WER_DUMP_MASK_DUMPTYPE
• WER_DUMP_MASK_ONLY_THISTHREAD
• WER_DUMP_MASK_OTHER_MODULESFLAGS
• WER_DUMP_MASK_OTHERTHREADFLAGS
• WER_DUMP_MASK_OTHERTHREADFLAGS_EX
• WER_DUMP_MASK_PREFERRED_MODULE_LIST
• WER_DUMP_MASK_PREFERRED_MODULESFLAGS
• WER_DUMP_MASK_THREADFLAGS
• WER_DUMP_MASK_THREADFLAGS_EX

dwDumpFlags

Informasi jenis yang akan disertakan dalam minidump. Anda dapat menentukan satu atau beberapa bendera MINIDUMP_TYPE .

Anggota ini hanya valid jika dwMask berisi WER_DUMP_MASK_DUMPTYPE.

bOnlyThisThread

Jika anggota ini TRUE dan dwMask berisi WER_DUMP_MASK_ONLY_THISTHREAD, minidump akan dikumpulkan hanya untuk utas panggilan.

dwExceptionThreadFlags

Jenis informasi utas yang akan disertakan dalam minidump. Anda dapat menentukan satu atau beberapa bendera THREAD_WRITE_FLAGS .

Anggota ini hanya valid jika dwMask berisi WER_DUMP_MASK_THREADFLAGS.

dwOtherThreadFlags

Jenis informasi utas yang akan disertakan dalam minidump. Anda dapat menentukan satu atau beberapa bendera THREAD_WRITE_FLAGS .

Anggota ini hanya valid jika dwMask berisi WER_DUMP_MASK_OTHERTHREADFLAGS.

dwExceptionThreadExFlags

Jenis informasi utas yang akan disertakan dalam minidump. Anda dapat menentukan satu atau beberapa bendera THREAD_WRITE_FLAGS .

Anggota ini hanya valid jika dwMask berisi WER_DUMP_MASK_THREADFLAGS_EX.

dwOtherThreadExFlags

Jenis informasi utas yang akan disertakan dalam minidump. Anda dapat menentukan satu atau beberapa bendera THREAD_WRITE_FLAGS .

Anggota ini hanya valid jika dwMask berisi WER_DUMP_MASK_OTHERTHREADFLAGS_EX.

dwPreferredModuleFlags

Jenis informasi modul yang akan disertakan dalam minidump untuk modul yang ditentukan dalam anggota wzPreferredModuleList . Anda dapat menentukan satu atau beberapa bendera MODULE_WRITE_FLAGS .

Anggota ini hanya valid jika dwMask berisi WER_DUMP_MASK_PREFERRED_MODULESFLAGS.

dwOtherModuleFlags

Jenis informasi modul yang akan disertakan dalam minidump. Anda dapat menentukan satu atau beberapa bendera MODULE_WRITE_FLAGS .

Anggota ini hanya valid jika dwMask berisi WER_DUMP_MASK_OTHER_MODULESFLAGS.

wzPreferredModuleList[WER_MAX_PREFERRED_MODULES_BUFFER]

Daftar nama modul (jangan sertakan jalur) tempat bendera dwPreferredModuleFlags berlaku. Setiap nama harus dihentikan null, dan daftar harus dihentikan dengan dua karakter null (misalnya, module1.dll\0module2.dll\0\0).

Untuk menentukan bahwa semua modul lebih disukai, atur anggota ini ke *\0\0. Jika Anda menyertakan * dalam daftar dengan nama modul lainnya, * diabaikan.

Anggota ini hanya valid jika dwMask berisi WER_DUMP_MASK_PREFERRED_MODULE_LIST.

Keterangan

Bendera yang ditentukan dalam struktur ini memiliki korelasi langsung ke bendera yang diteruskan dalam fungsi panggilan balik MINIDUMP_CALLBACK_ROUTINE fungsi panggilan balik (lihat fungsi MiniDumpWriteDump) saat WER menghasilkan file cadangan.

Jika jenis input panggilan balik minidump adalah ThreadCallback (lihat anggota CallbackType dari struktur MINIDUMP_CALLBACK_INPUT), anggota ThreadWriteFlags dari struktur MINIDUMP_CALLBACK_OUTPUT diatur ke bendera yang ditentukan dalam dwExceptionThreadFlags, dwExceptionThreadExFlags, dwOtherThreadFlags, atau anggota dwOtherThreadExFlags . Jika panggilan balik adalah untuk utas yang crash, bendera dwExceptionThreadFlags atau dwExceptionThreadExFlags digunakan; jika tidak, bendera dwOtherThreadFlags atau dwOtherThreadExFlags digunakan.

Jika jenis input panggilan balik adalah ModuleCallback, anggota ModuleWriteFlags dari struktur MINIDUMP_CALLBACK_OUTPUT diatur ke bendera yang ditentukan dalam anggota dwPreferredModuleFlags atau dwOtherModuleFlags . Jika panggilan balik adalah untuk modul pada daftar modul pilihan, bendera dwPreferredModuleFlags digunakan; jika tidak, bendera dwOtherModuleFlags digunakan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	werapi.h

Lihat juga

Fungsi WerReportAddDump, Pelaporan Galat Windows