WER_DUMP_CUSTOM_OPTIONS_V3 結構 (werapi.h)

指定要在背景 (中收集的自定義 Windows 錯誤報告 (WER) 迷你傾印資訊，而不需暫停 PssCaptureSnapshot 函式) 的程式。

語法

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;

成員

dwSize

結構的大小，以位元組為單位。

dwMask

遮罩，可控制此結構中哪些選項有效。 您可以指定下列一或多個值：

• 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

要包含在迷你傾印中的類型資訊。 您可以指定一或多個 MINIDUMP_TYPE 旗標。

只有當 dwMask 包含WER_DUMP_MASK_DUMPTYPE時，這個成員才有效。

bOnlyThisThread

如果此成員為 TRUE ，且 dwMask 包含WER_DUMP_MASK_ONLY_THISTHREAD，則只會針對呼叫線程收集迷你傾印。

dwExceptionThreadFlags

要包含在迷你傾印中的線程信息類型。 您可以指定一或多個 THREAD_WRITE_FLAGS 旗標。

只有當 dwMask 包含WER_DUMP_MASK_THREADFLAGS時，這個成員才有效。

dwOtherThreadFlags

要包含在迷你傾印中的線程信息類型。 您可以指定一或多個 THREAD_WRITE_FLAGS 旗標。

只有當 dwMask 包含WER_DUMP_MASK_OTHERTHREADFLAGS時，這個成員才有效。

dwExceptionThreadExFlags

要包含在迷你傾印中的線程信息類型。 您可以指定一或多個 THREAD_WRITE_FLAGS 旗標。

只有當 dwMask 包含WER_DUMP_MASK_THREADFLAGS_EX時，這個成員才有效。

dwOtherThreadExFlags

要包含在迷你傾印中的線程信息類型。 您可以指定一或多個 THREAD_WRITE_FLAGS 旗標。

只有當 dwMask 包含WER_DUMP_MASK_OTHERTHREADFLAGS_EX時，這個成員才有效。

dwPreferredModuleFlags

要在 wzPreferredModuleList 成員中所指定模組的迷你傾印中包含的模組資訊類型。 您可以指定一或多個 MODULE_WRITE_FLAGS 旗標。

只有當 dwMask 包含WER_DUMP_MASK_PREFERRED_MODULESFLAGS時，這個成員才有效。

dwOtherModuleFlags

要包含在迷你傾印中的模組信息類型。 您可以指定一或多個 MODULE_WRITE_FLAGS 旗標。

只有當 dwMask 包含WER_DUMP_MASK_OTHER_MODULESFLAGS時，這個成員才有效。

wzPreferredModuleList[WER_MAX_PREFERRED_MODULES_BUFFER]

(的模組名稱清單不包含 dwPreferredModuleFlags 旗標套用至的路徑) 。 每個名稱都必須以 null 結尾，而且清單必須以兩個 null (字元終止，例如，module1.dll\0module2.dll\0\0) 。

若要指定所有模組都是慣用的，請將此成員設定為 *\0\0。 如果您包含在 * 具有其他模組名稱的清單中， * 則會忽略 。

只有當 dwMask 包含WER_DUMP_MASK_PREFERRED_MODULE_LIST時，這個成員才有效。

dwPreferredModuleResetFlags

要包含在 wzPreferredModuleList 成員中所指定模組的迷你傾印中慣用的模組資訊類型。 您可以指定一或多個 MODULE_WRITE_FLAGS 旗標。

只有當 dwMask 包含WER_DUMP_MASK_PREFERRED_MODULESFLAGS時，這個成員才有效。

dwOtherModuleResetFlags

要包含在 wzPreferredModuleList 成員所指定模組的迷你傾印中的其他模組信息類型。 您可以指定一或多個 MODULE_WRITE_FLAGS 旗標。

只有當 dwMask 包含WER_DUMP_MASK_PREFERRED_MODULESFLAGS時，這個成員才有效。

pvDumpKey

傾印金鑰值。

hSnapshot

目標進程快照集的句柄。

dwThreadID

線程標識碼。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	werapi.h

另請參閱

WerReportAddDump 函式、PssCaptureSnapshot、Windows 錯誤報告