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

Статья
03/03/2024

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

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

Синтаксис

PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE PfnWerRuntimeExceptionEventSignature;

HRESULT PfnWerRuntimeExceptionEventSignature(
  [in]      PVOID pContext,
  [in]      const PWER_RUNTIME_EXCEPTION_INFORMATION pExceptionInformation,
  [in]      DWORD dwIndex,
  [out]     PWSTR pwszName,
  [in, out] PDWORD pchName,
  [out]     PWSTR pwszValue,
  [in, out] PDWORD pchValue
)
{...}

Параметры

[in] pContext

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

[in] pExceptionInformation

Структура WER_RUNTIME_EXCEPTION_INFORMATION , содержащая сведения об исключении.

[in] dwIndex

Индекс параметра отчета. Допустимые значения: от 0 до 9. При первом вызове этой функции индекс должен быть равным 0, а каждый последующий вызов должен последовательно увеличивать значение индекса.

[out] pwszName

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

[in, out] pchName

Размер буфера pwszName в символах. Размер включает символ конца null.

[out] pwszValue

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

[in, out] pchValue

Размер буфера pwszValue в символах. Размер включает символ конца null.

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

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

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

WER вызывает эту функцию обратного вызова, только если для параметра pbOwnershipClaimed функции обратного вызова OutOfProcessExceptionEventCallback задано значение TRUE. Параметр pdwSignatureCountобъекта OutOfProcessExceptionEventCallback определяет количество вызовов этой функции обратного вызова.

Требования

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

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

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