WER_DUMP_CUSTOM_OPTIONS 結構 (werapi.h)
指定要由 WerReportAddDump 函式收集的自訂 Windows 錯誤報告 (WER) 迷你dump 資訊。
語法
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;
成員
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時，這個成員才有效。
備註
此結構中指定的旗標與在 MINIDUMP_CALLBACK_ROUTINE回 呼函式回呼函式中傳遞的旗標有直接相互關聯， (WER 產生傾印檔案時，請參閱 MiniDumpWriteDump 函 式函式) 。
如果迷你傾印的回呼輸入類型為 ThreadCallback (看到 MINIDUMP_CALLBACK_INPUT 結構的CallbackType 成員) ，MINIDUMP_CALLBACK_OUTPUT 結構的ThreadWriteFlags 成員會設定為 dwExceptionThreadFlags、dwExceptionThreadExFlags、dwOtherThreadFlags 或 dwOtherThreadExFlags 成員中指定的旗標。 如果回呼適用於損毀線程，則會使用 dwExceptionThreadFlags 或 dwExceptionThreadExFlags 旗標;否則，會使用 dwOtherThreadFlags 或 dwOtherThreadExFlags 旗標。
如果回呼輸入類型為ModuleCallback，MINIDUMP_CALLBACK_OUTPUT結構的ModuleWriteFlags成員會設定為 dwPreferredModuleFlags 或 dwOtherModuleFlags 成員中指定的旗標。 如果回呼適用於慣用模塊清單上的模組，則會使用 dwPreferredModuleFlags 旗標;否則，會使用 dwOtherModuleFlags 旗標。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 標頭 | werapi.h |