Compartilhar via

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

  • Artigo

Relatório de Erros do Windows (WER) chama essa função para obter os parâmetros de relatório que descrevem exclusivamente o problema.

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

Sintaxe

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

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.

[in] dwIndex

O índice do parâmetro de relatório. Os valores válidos são de 0 a 9. A primeira chamada para essa função deve definir o índice como 0 e cada chamada sucessiva deve incrementar o valor do índice sequencialmente.

[out] pwszName

Um buffer alocado pelo chamador que você usa para especificar o nome do parâmetro.

[in, out] pchName

O tamanho, em caracteres, do buffer pwszName . O tamanho inclui o caractere de terminação nula.

[out] pwszValue

Um buffer alocado pelo chamador que você usa para especificar o valor do parâmetro.

[in, out] pchValue

O tamanho, em caracteres, do buffer pwszValue . O tamanho inclui o caractere de terminação nula.

Retornar valor

Retorne S_OK em caso de êxito. Se você retornar outros códigos de falha, o WER reverterá para seu comportamento padrão de relatório de falhas.

Comentários

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

Para gerar relatórios de erros para problemas específicos do aplicativo, o aplicativo deve criar uma breve descrição do problema usando algumas informações básicas chamadas parâmetros de relatório. Os parâmetros de relatório incluem informações como o nome do aplicativo, a versão do aplicativo, o nome do módulo, a versão do módulo e o código de erro. A combinação desses parâmetros de relatório descreve um problema exclusivo.

O WER chamará essa função de retorno de chamada somente se você definir o parâmetro pbOwnershipClaimed da função de retorno de chamada OutOfProcessExceptionEventCallback como TRUE. O parâmetro pdwSignatureCount de OutOfProcessExceptionEventCallback determina o número de vezes que o WER chamará essa função de retorno de chamada.

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