Compartilhar via

PFN_WER_RUNTIME_EXCEPTION_EVENT função de retorno de chamada (werapi.h)

  • Artigo

Relatório de Erros do Windows (WER) chama essa função para determinar se o manipulador de exceção está reivindicando a falha.

O tipo PFN_WER_RUNTIME_EXCEPTION_EVENT define um ponteiro para essa função de retorno de chamada. Você deve usar "OutOfProcessExceptionEventCallback" como o nome da função de retorno de chamada.

Sintaxe

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
)
{...}

Parâmetros

[in] pContext

Um ponteiro para informações de contexto arbitrárias que você especificou quando chamou a função WerRegisterRuntimeExceptionModule para registrar o manipulador de exceção.

[in] pExceptionInformation

Uma estrutura WER_RUNTIME_EXCEPTION_INFORMATION que contém as informações de exceção. Use as informações para determinar se você deseja reivindicar a falha.

[out] pbOwnershipClaimed

Defina como TRUE se o manipulador de exceção estiver reivindicando essa falha; caso contrário, FALSE. Se você definir esse parâmetro como FALSE, não defina o restante dos parâmetros out.

[out] pwszEventName

Um buffer alocado pelo chamador que você usa para especificar o nome do evento usado para identificar essa falha.

[in, out] pchSize

O tamanho, em caracteres, do buffer pwszEventName . O buffer é limitado a MAX_PATH caracteres. O tamanho inclui o caractere de terminação nula.

[out] pdwSignatureCount

O número de parâmetros de relatório que você fornecerá. O intervalo válido de valores é de um a 10. Se você especificar um valor maior que 10, o WER ignorará o valor e coletará apenas os primeiros 10 parâmetros. Se você especificar zero, o processo de relatório será indeterminado.

Esse valor determina o número de vezes que o WER chama a função OutOfProcessExceptionEventSignatureCallback .

Retornar valor

Retorne S_OK, mesmo que o manipulador de exceção não esteja reivindicando essa falha. Se você retornar outros códigos de falha, o WER reverterá para seu comportamento de relatório de falhas padrão se nenhum outro manipulador estiver registrado.

Comentários

Você deve implementar essa função na DLL do manipulador de exceção.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho werapi.h

Confira também

WerRegisterRuntimeExceptionModule, Relatório de Erros do Windows