функция обратного вызова PFN_WER_RUNTIME_EXCEPTION_EVENT (werapi.h)

Статья
07/27/2023

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

Тип PFN_WER_RUNTIME_EXCEPTION_EVENT определяет указатель на эту функцию обратного вызова. В качестве имени функции обратного вызова необходимо использовать OutOfProcessExceptionEventCallback.

Синтаксис

PFN_WER_RUNTIME_EXCEPTION_EVENT PfnWerRuntimeExceptionEvent;

HRESULT PfnWerRuntimeExceptionEvent(
  [in]      PVOID pContext,
  [in]      const PWER_RUNTIME_EXCEPTION_INFORMATION pExceptionInformation,
  [out]     BOOL *pbOwnershipClaimed,
  [out]     PWSTR pwszEventName,
  [in, out] PDWORD pchSize,
  [out]     PDWORD pdwSignatureCount
)
{...}

Параметры

[in] pContext

Указатель на произвольные сведения контекста, указанные при вызове функции WerRegisterRuntimeExceptionModule для регистрации обработчика исключений.

[in] pExceptionInformation

Структура WER_RUNTIME_EXCEPTION_INFORMATION , содержащая сведения об исключении. Используйте эти сведения, чтобы определить, хотите ли вы запросить сбой.

[out] pbOwnershipClaimed

Задайте значение TRUE , если обработчик исключений утверждает этот сбой; в противном случае — FALSE. Если для этого параметра задано значение FALSE, не устанавливайте остальные параметры out.

[out] pwszEventName

Выделенный вызывающим объектом буфер, который используется для указания имени события, используемого для идентификации этого сбоя.

[in, out] pchSize

Размер (в символах) буфера pwszEventName . Буфер ограничен MAX_PATH символами. Размер включает символ, завершающий значение NULL.

[out] pdwSignatureCount

Количество параметров отчета, которые вы укатите. Допустимый диапазон значений — от 1 до 10. Если указать значение больше 10, WER проигнорирует это значение и соберет только первые 10 параметров. Если указать ноль, процесс создания отчетов будет неопределенным.

Это значение определяет количество вызовов функции OutOfProcessExceptionEventSignatureCallback .

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

Возвращайте S_OK, даже если обработчик исключений не утверждает этот сбой. Если вы возвращаете другие коды сбоев, WER возвращается к стандартному поведению отчетов о сбоях, если другие обработчики не зарегистрированы.

Требования

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

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

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