struktur WER_DUMP_CUSTOM_OPTIONS_V3 (werapi.h)

Menentukan informasi minidump Pelaporan Galat Windows kustom (WER) yang akan dikumpulkan di latar belakang (tanpa menjeda proses) oleh fungsi PssCaptureSnapshot.

Sintaks

typedef struct _WER_DUMP_CUSTOM_OPTIONS_V3 {
  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];
  DWORD  dwPreferredModuleResetFlags;
  DWORD  dwOtherModuleResetFlags;
  PVOID  pvDumpKey;
  HANDLE hSnapshot;
  DWORD  dwThreadID;
} WER_DUMP_CUSTOM_OPTIONS_V3, *PWER_DUMP_CUSTOM_OPTIONS_V3;

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 untuk 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 untuk 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 untuk 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 untuk 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 untuk 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 untuk 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 lain, * akan diabaikan.

Anggota ini hanya valid jika dwMask berisi WER_DUMP_MASK_PREFERRED_MODULE_LIST.

dwPreferredModuleResetFlags

Jenis informasi modul yang disukai untuk 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.

dwOtherModuleResetFlags

Jenis informasi modul lainnya untuk 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.

pvDumpKey

Nilai kunci cadangan.

hSnapshot

Tangani ke rekam jepret proses target.

dwThreadID

ID utas.

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, PssCaptureSnapshot, Pelaporan Galat Windows