WER_DUMP_CUSTOM_OPTIONS_V2 structure (werapi.h)

Specifies custom Windows Error Reporting (WER) minidump information to be collected by the WerReportAddDump function.

Syntax

typedef struct _WER_DUMP_CUSTOM_OPTIONS_V2 {
  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;
} WER_DUMP_CUSTOM_OPTIONS_V2, *PWER_DUMP_CUSTOM_OPTIONS_V2;

Members

dwSize

The size of the structure, in bytes.

dwMask

A mask that controls which options are valid in this structure. You can specify one or more of the following values:

  • 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

The type information to include in the minidump. You can specify one or more of the MINIDUMP_TYPE flags.

This member is valid only if dwMask contains WER_DUMP_MASK_DUMPTYPE.

bOnlyThisThread

If this member is TRUE and dwMask contains WER_DUMP_MASK_ONLY_THISTHREAD, the minidump is to be collected only for the calling thread.

dwExceptionThreadFlags

The type of thread information to include in the minidump. You can specify one or more of the THREAD_WRITE_FLAGS flags.

This member is valid only if dwMask contains WER_DUMP_MASK_THREADFLAGS.

dwOtherThreadFlags

The type of thread information to include in the minidump. You can specify one or more of the THREAD_WRITE_FLAGS flags.

This member is valid only if dwMask contains WER_DUMP_MASK_OTHERTHREADFLAGS.

dwExceptionThreadExFlags

The type of thread information to include in the minidump. You can specify one or more of the THREAD_WRITE_FLAGS flags.

This member is valid only if dwMask contains WER_DUMP_MASK_THREADFLAGS_EX.

dwOtherThreadExFlags

The type of thread information to include in the minidump. You can specify one or more of the THREAD_WRITE_FLAGS flags.

This member is valid only if dwMask contains WER_DUMP_MASK_OTHERTHREADFLAGS_EX.

dwPreferredModuleFlags

The type of module information to include in the minidump for modules specified in the wzPreferredModuleList member. You can specify one or more of the MODULE_WRITE_FLAGS flags.

This member is valid only if dwMask contains WER_DUMP_MASK_PREFERRED_MODULESFLAGS.

dwOtherModuleFlags

The type of module information to include in the minidump. You can specify one or more of the MODULE_WRITE_FLAGS flags.

This member is valid only if dwMask contains WER_DUMP_MASK_OTHER_MODULESFLAGS.

wzPreferredModuleList[WER_MAX_PREFERRED_MODULES_BUFFER]

A list of module names (do not include the path) to which the dwPreferredModuleFlags flags apply. Each name must be null-terminated, and the list must be terminated with two null characters (for example, module1.dll\0module2.dll\0\0).

To specify that all modules are preferred, set this member to *\0\0. If you include * in a list with other module names, the * is ignored.

This member is valid only if dwMask contains WER_DUMP_MASK_PREFERRED_MODULE_LIST.

dwPreferredModuleResetFlags

The preferred type of module information to include in the minidump for modules specified in the wzPreferredModuleList member. You can specify one or more of the MODULE_WRITE_FLAGS flags.

This member is valid only if dwMask contains WER_DUMP_MASK_PREFERRED_MODULESFLAGS.

dwOtherModuleResetFlags

Other types of module information to include in the minidump for modules specified in the wzPreferredModuleList member. You can specify one or more of the MODULE_WRITE_FLAGS flags.

This member is valid only if dwMask contains WER_DUMP_MASK_PREFERRED_MODULESFLAGS.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header werapi.h

See also

WerReportAddDump function, Windows Error Reporting