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