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

  • Статья

Регистрирует процесс для включения в отчет отчеты об ошибках Windows (WER) вместе с процессом main приложения. При необходимости указывает поток в этом зарегистрированном процессе для получения дополнительных данных.

Синтаксис

HRESULT WerRegisterAdditionalProcess(
             DWORD processId,
  [optional] DWORD captureExtraInfoForThreadId
);

Параметры

processId

Идентификатор регистрируемого процесса.

[optional] captureExtraInfoForThreadId

Идентификатор потока в зарегистрированном процессе, из которого запрашивается дополнительная информация.

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

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

Код возврата Описание
E_INVALIDARG Значение processId равно 0.
E_OUTOFMEMORY WER не удалось выделить достаточно большую кучу для данных.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) Количество зарегистрированных записей WER (блоки памяти, метаданные, файлы) превышает максимальное (WER_MAX_REGISTERED_ENTRIES) или максимальное число процессов (WER_MAX_REGISTERED_DUMPCOLLECTION)
WER_E_INVALID_STATE Недопустимое состояние процесса. Например, процесс находится в режиме восстановления приложения.

Комментарии

Этот API предназначен для приложений с несколькими процессами, взаимодействующими друг с другом. Процесс main приложения регистрирует идентификатор другого процесса. При сбое процесса регистрации WER добавит дополнительный дамп рассмотрения зарегистрированного процесса в результирующий диагностика. При необходимости процесс регистрации также может предоставить идентификатор потока, чтобы получить дополнительные данные для конкретного потока.

Требования

Требование Значение
Минимальная версия клиента Windows 10, версия 1703 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2016 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header werapi.h
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

WerUnregisterAdditionalProcess, отчеты об ошибках Windows