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

如果此成员为 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时,此成员才有效。

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

线程 ID。

要求

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

另请参阅

WerReportAddDump 函数PssCaptureSnapshot、Windows 错误报告