структура WER_DUMP_CUSTOM_OPTIONS (werapi.h)

  • Статья

Указывает сведения о минидампе пользовательского отчеты об ошибках Windows (WER), собираемые функцией WerReportAddDump.

Синтаксис

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 (см. функцию MiniDumpWriteDump), когда WER создает файл дампа.

Если тип входных данных обратного вызова minidump — ThreadCallback (см. элемент CallbackTypeструктуры MINIDUMP_CALLBACK_INPUT), то для элемента ThreadWriteFlagsMINIDUMP_CALLBACK_OUTPUT структуры задается флаги, указанные в элементах dwExceptionThreadFlags, dwExceptionThreadExFlags, dwOtherThreadFlags или dwOtherThreadExFlags . Если обратный вызов предназначен для потока, завершающегося сбоем, используются флаги dwExceptionThreadFlags или dwExceptionThreadExFlags ; в противном случае используются флаги dwOtherThreadFlags или dwOtherThreadExFlags .

Если тип входных данных обратного вызова — ModuleCallback, для элемента ModuleWriteFlagsMINIDUMP_CALLBACK_OUTPUT структуры устанавливаются флаги, указанные в элементах dwPreferredModuleFlags или dwOtherModuleFlags . Если обратный вызов предназначен для модуля в списке предпочтительных модулей, используются флаги dwPreferredModuleFlags ; в противном случае используются флаги dwOtherModuleFlags .

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Верхняя часть werapi.h

См. также раздел

Функция WerReportAddDump, отчеты об ошибках Windows