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

如果此成员为 TRUEdwMask 包含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 成员设置为 dwExceptionThreadFlagsdwExceptionThreadExFlagsdwOtherThreadFlagsdwOtherThreadExFlags 成员中指定的标志。 如果回调针对崩溃线程,则使用 dwExceptionThreadFlagsdwExceptionThreadExFlags 标志;否则,使用 dwOtherThreadFlagsdwOtherThreadExFlags 标志。

如果回调输入类型为 ModuleCallback,则将MINIDUMP_CALLBACK_OUTPUT 结构的ModuleWriteFlags 成员设置为 dwPreferredModuleFlagsdwOtherModuleFlags 成员中指定的标志。 如果回调适用于首选模块列表中的模块,则使用 dwPreferredModuleFlags 标志;否则,使用 dwOtherModuleFlags 标志。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 werapi.h

另请参阅

WerReportAddDump 函数Windows 错误报告