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 旗標。

規格需求

另請參閱

WerReportAddDump 函式，Windows 錯誤報告