Usando WER

  • Artigo
  • 5 minutos para ler

Começando com Windows Vista, Windows fornece relatórios de erros de falha, não resposta e kernel por padrão, sem exigir alterações no aplicativo. O relatório incluirá informações de despejo de minidump e heap, se necessário. Em vez disso, os aplicativos usam a API WER para enviar relatórios de problemas específicos do aplicativo para a Microsoft.

Como Windows relata automaticamente exceções sem tratamento, o aplicativo não deve lidar com exceções fatais. Se o processo de falha ou não responder for interativo, o WER exibirá uma interface do usuário informando ao usuário sobre o problema. Um aplicativo será considerado sem resposta se não responder às mensagens Windows por cinco segundos enquanto o usuário está tentando interagir com o aplicativo.

Windows fluxo de relatório de erros para falhas, não respostas e kernel

O exemplo a seguir mostra as etapas que ocorrem para uma falha de aplicativo, não resposta ou falha de kernel.

  1. O evento de problema ocorre.
  2. O sistema operacional invoca WER.
  3. O WER coleta os dados, cria um relatório e solicita o consentimento do usuário (se necessário).
  4. O WER enviará o relatório à Microsoft (Watson Server) se o usuário consentiu.
  5. Se o servidor Watson solicitar dados adicionais, o WER coletará os dados e solicitará consentimento ao usuário (se necessário).
  6. Se o aplicativo tiver se registrado para recuperação e reinicialização, o WER executará as funções de retorno de chamada registradas enquanto os dados são compactados e enviados para a Microsoft (se o usuário consentiu).
  7. Se uma resposta ao problema estiver disponível na Microsoft, o usuário será notificado.

Os aplicativos podem usar as seguintes funções para personalizar o conteúdo do relatório enviado à Microsoft. As funções de registro dizem ao WER para incluir os arquivos e blocos de memória específicos no relatório de erro que ele cria.

Windows fluxo relatório de erros para relatórios de eventos genéricos

As etapas a seguir mostram como os aplicativos podem obter um relatório de erro para uma condição de erro não fatal.

  1. O evento de problema não fatal ocorre.
  2. O aplicativo reconhece o evento e usa a seguinte sequência de chamadas de função para gerar o relatório.
    1. Chame a função WerReportCreate para criar o relatório.
    2. Chame a função WerReportSetParameter para definir os parâmetros de relatório.
    3. Chame a função WerReportAddFile para adicionar arquivos ao relatório.
    4. Chame a função WerReportAddDump para adicionar um minidump ao relatório (se necessário).
    5. Chame a função WerReportSubmit para enviar o relatório.
    6. Chame o WerReportCloseHandle para liberar recursos.
  3. Dependendo das opções específicas usadas ao chamar as funções na etapa 2, o WER concluirá o relatório de erros. O WER garantirá que o relatório seja feito de acordo com as políticas definidas pelo usuário. Por exemplo, o WER enviará o relatório para a Microsoft, enfileirará o relatório e mostrará as interfaces de usuário apropriadas para o usuário.

Excluindo um aplicativo de Windows Relatório de Erros

Para excluir seu aplicativo de Windows relatório de erros, use a função WerAddExcludedApplication. Para restaurar o relatório de erros para seu aplicativo, use a função WerRemoveExcludedApplication .

Recuperando dados automaticamente e reiniciando um aplicativo com falha

Um aplicativo pode usar a Recuperação de Aplicativos e Reiniciar para salvar dados e informações de estado antes que o aplicativo seja encerrado devido a uma exceção sem tratamento ou quando o aplicativo parar de responder. O aplicativo também será reiniciado, se solicitado. Para obter detalhes, consulte Recuperação de Aplicativo e Reinicialização.

API herdada

Um aplicativo pode relatar uma falha chamando a função ReportFault . No entanto, você não deve usar a função ReportFault , a menos que tenha um requisito muito específico que o comportamento padrão de relatório de erros do sistema operacional não possa atender.

Se o relatório de erros estiver habilitado, o sistema exibirá uma caixa de diálogo para o usuário indicando que o aplicativo encontrou um problema e será fechado. Se houver um depurador configurado na chave HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\AeDebug , o usuário recebe a opção de iniciar o depurador. O usuário também tem a opção de enviar um relatório para a Microsoft. Se o usuário enviar o relatório, o sistema exibirá outra caixa de diálogo agradecendo ao usuário pelo relatório e fornecendo um link para mais informações.

O sistema de relatórios de erros dá suporte aos seguintes modos de operação.

Modo de operação Descrição
Relatórios de memória compartilhada Se o contexto de segurança do aplicativo for o mesmo que o contexto de segurança do usuário conectado, o sistema de relatórios de erros usará um bloco de memória compartilhada para comunicação. Esse modo não pode ser usado com o modo de relatório de manifesto.
Relatório de manifesto Se o contexto de segurança do aplicativo não for o mesmo que o contexto de segurança do usuário conectado, o sistema de relatórios de erros usará um arquivo para comunicação. Esse modo também é usado para relatar aplicativos sem resposta e falhas de kernel. Esse modo não pode ser usado com o modo de relatório de memória compartilhada.
Relatórios da Internet O sistema de relatórios de erros envia todos os dados para a Microsoft por meio da Internet. Este é o modo de operação padrão. Ele não pode ser usado com o modo de relatório corporativo. Esse modo é usado quando não há nenhum caminho de upload corporativo especificado pelo administrador.
Relatórios corporativos O sistema de relatórios de erros envia todos os dados para um compartilhamento de arquivos em vez de carregá-los diretamente para a Microsoft. Isso permite que os gerentes de TI corporativos examinem os dados antes de serem enviados para a Microsoft. Esse modo é usado quando há um caminho de upload corporativo especificado pelo administrador. Ele não pode ser usado com o modo de relatório da Internet.
Relatórios sem cabeça O sistema de relatório de erros não exibirá nenhuma caixa de diálogo para o usuário. Isso permite que os gerentes de TI corporativos coletem relatórios de erros de seus funcionários o tempo todo. Esse modo é usado quando o relatório é habilitado pelo administrador, mas a notificação é desabilitada. Ele só pode ser usado com o modo de relatório corporativo.

Para excluir seu aplicativo do relatório de erros, use a função AddERExcludedApplication .