Share via

Функция WerReportAddDump (werapi.h)

  • Статья

Добавляет дамп указанного типа в указанный отчет отчеты об ошибках Windows (WER).

Синтаксис

HRESULT WerReportAddDump(
  [in]           HREPORT                    hReportHandle,
  [in]           HANDLE                     hProcess,
  [in, optional] HANDLE                     hThread,
  [in]           WER_DUMP_TYPE              dumpType,
  [in, optional] PWER_EXCEPTION_INFORMATION pExceptionParam,
  [in, optional] PWER_DUMP_CUSTOM_OPTIONS   pDumpCustomOptions,
  [in]           DWORD                      dwFlags
);

Параметры

[in] hReportHandle

Дескриптор отчета. Этот дескриптор возвращается функцией WerReportCreate .

[in] hProcess

Дескриптор процесса, для которого создается отчет. Этот дескриптор должен иметь права доступа STANDARD_RIGHTS_READ и PROCESS_QUERY_INFORMATION.

[in, optional] hThread

Дескриптор потока hProcess , для которого создается отчет. Если dumpType имеет значение WerDumpTypeMicro, этот параметр является обязательным. Для других типов дампа этот параметр может иметь значение NULL.

[in] dumpType

Тип минидампа. Этот параметр может быть одним из следующих значений из типа перечисления WER_DUMP_TYPE .

Значение Значение
WerDumpTypeHeapDump
 Расширенный минидамп, содержащий дополнительные данные, такие как память процесса.

Этот тип эквивалентен созданию минидампа со следующими параметрами:

  • MiniDumpWithDataSegs
  • MiniDumpWithProcessThreadData
  • MiniDumpWithHandleData
  • MiniDumpWithPrivateReadWriteMemory
  • MiniDumpWithUnloadedModules
  • MiniDumpWithFullMemoryInfo
  • MiniDumpWithThreadInfo (Windows 7 и более поздние версии)
  • MiniDumpWithTokenInformation (Windows 7 и более поздние версии)
  • MiniDumpWithPrivateWriteCopyMemory (Windows 7 и более поздние версии)
WerDumpTypeMicroDump
 Ограниченный минидамп, содержащий только трассировку стека.

Этот тип эквивалентен созданию минидампа со следующими параметрами:

  • MiniDumpWithDataSegs
  • MiniDumpWithUnloadedModules
  • MiniDumpWithProcessThreadData
  • MiniDumpWithoutOptionalData
WerDumpTypeMiniDump
 Минидамп.

Этот тип эквивалентен созданию минидампа со следующими параметрами:

  • MiniDumpWithDataSegs
  • MiniDumpWithUnloadedModules
  • MiniDumpWithProcessThreadData
  • MiniDumpWithTokenInformation (Windows 7 и более поздние версии)

[in, optional] pExceptionParam

Указатель на структуру WER_EXCEPTION_INFORMATION , указывающую сведения об исключении.

[in, optional] pDumpCustomOptions

Указатель на структуру WER_DUMP_CUSTOM_OPTIONS , указывающую пользовательские параметры минидампа. Если этот параметр имеет значение NULL, собираются стандартные сведения о минидампе.

[in] dwFlags

Этот параметр может иметь значение 0 или следующее.

Значение Значение
WER_DUMP_NOHEAP_ONQUEUE
 Если отчет помещается в очередь, не включайте дамп кучи. Использование этого флага экономит место на диске.

Возвращаемое значение

Эта функция возвращает S_OK при успешном выполнении или код ошибки при сбое.

Комментарии

Используйте эту функцию только для общих отчетов— она не влияет на отчеты о сбоях операционной системы или отсутствии ответов.

Если сервер запрашивает мини-дамп и вы указываете WerDumpTypeHeapDump для параметра dumpType , WER не будет отправлять дамп кучи на сервер Watson. Однако если сервер запрашивает дамп кучи, а dumpType — WerDumpTypeMiniDump, WER отправит на сервер мини-дамп. Поэтому рекомендуется задать для dumpType значение WerDumpTypeMiniDump.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header werapi.h
Библиотека Wer.lib
DLL Wer.dll

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

Файлы minidump, WER_DUMP_CUSTOM_OPTIONS, WER_EXCEPTION_INFORMATION, WerReportCreate, отчеты об ошибках Windows