структура 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

Обработка до целевого процесса snapshot.

dwThreadID

Идентификатор потока.

Требования

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

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

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