WER_DUMP_CUSTOM_OPTIONS 结构 (werapi.h)
指定要由 WerReportAddDump 函数收集的自定义Windows 错误报告 (WER) 小型转储信息。
语法
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 (see the CallbackType member of MINIDUMP_CALLBACK_INPUT structure) ，则 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 |