Função WerReportSubmit (werapi.h)

  • Artigo

Envia o relatório de RELATÓRIO DE ERROS DO WINDOWS (WER) especificado.

Sintaxe

HRESULT WerReportSubmit(
  [in]            HREPORT            hReportHandle,
  [in]            WER_CONSENT        consent,
  [in]            DWORD              dwFlags,
  [out, optional] PWER_SUBMIT_RESULT pSubmitResult
);

Parâmetros

[in] hReportHandle

Um identificador para o relatório. Esse identificador é retornado pela função WerReportCreate .

[in] consent

O status de consentimento. Esse parâmetro pode ser um dos seguintes valores do tipo de enumeração WER_CONSENT.

Valor Significado
WerConsentAlwaysPrompt
4		 O usuário sempre é solicitado a enviar a solicitação.
WerConsentApproved
2		 O usuário aprovou a solicitação de envio.
WerConsentDenied
3		 O usuário negou a solicitação de envio.
WerConsentMax
5		 O valor máximo para o tipo de enumeração WER_CONSENT .
WerConsentNotAsked
1		 O usuário não foi solicitado a consentir.

[in] dwFlags

Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
WER_SUBMIT_ADD_REGISTERED_DATA
16		 Adicione os dados registrados por WerSetFlags, WerRegisterFile e WerRegisterMemoryBlock ao relatório.
WER_SUBMIT_HONOR_RECOVERY
1		 Honre qualquer registro de recuperação para o aplicativo. Para obter mais informações, consulte RegisterApplicationRecoveryCallback.
WER_SUBMIT_HONOR_RESTART
2		 Honre qualquer registro de reinicialização para o aplicativo. Para obter mais informações, consulte RegisterApplicationRestart.
WER_SUBMIT_NO_ARCHIVE
256		 Não arquive o relatório.
WER_SUBMIT_NO_CLOSE_UI
64		 Não exiba a caixa de diálogo fechar para o relatório crítico.
WER_SUBMIT_NO_QUEUE
128		 Não enfileira o relatório. Se houver consentimento adequado do usuário, o relatório será enviado à Microsoft imediatamente; caso contrário, o relatório será descartado. Você pode usar esse sinalizador para relatórios não críticos.

O relatório é descartado para qualquer ação que exija que o relatório seja enfileirado. Por exemplo, se o computador estiver offline quando você enviar o relatório, o relatório será descartado. Além disso, se não houver consentimento suficiente (por exemplo, o consentimento foi necessário para a parte de dados do relatório), o relatório será descartado.
WER_SUBMIT_OUTOFPROCESS
32		 Gere outro processo para enviar o relatório. O thread de chamada é bloqueado até que a função retorne.

NOTA: As mensagens de janela serão bombeadas para que a atividade de interface do usuário no thread de chamada não seja bloqueada.
WER_SUBMIT_OUTOFPROCESS_ASYNC
1024		 Gere outro processo para enviar o relatório e retornar dessa chamada de função imediatamente. Observe que o conteúdo do parâmetro pSubmitResult é indefinido e não há como consultar quando o relatório é concluído ou a conclusão status.
WER_SUBMIT_QUEUE
4		 Adicione o relatório à fila do WER sem notificar o usuário. O relatório é enfileirado apenas — o relatório (enviar o relatório para a Microsoft) ocorre posteriormente com base no nível de consentimento do usuário.
WER_SUBMIT_SHOW_DEBUG
8		 Mostrar o botão de depuração.
WER_SUBMIT_START_MINIMIZED
512		 A interface do usuário inicial é minimizada e piscando.
WER_SUBMIT_BYPASS_DATA_THROTTLING
2.048		 Ignorar a limitação de dados para o relatório.

Windows 7 ou anterior: Esse parâmetro não está disponível.
WER_SUBMIT_ARCHIVE_PARAMETERS_ONLY
4096		 Arquivar somente os parâmetros; o táxi é descartado. Esse sinalizador substitui a configuração configurar WERarchive .

Windows 7 ou anterior: Esse parâmetro não está disponível.
WER_SUBMIT_REPORT_MACHINE_ID
8192		 Sempre envie o identificador de computador exclusivo de 128 bits com o relatório, independentemente do consentimento com o qual o relatório foi enviado. Consulte Comentários para obter informações adicionais.

Windows 7 ou anterior: Esse parâmetro não está disponível.

[out, optional] pSubmitResult

O resultado do envio. Esse parâmetro pode ser um dos seguintes valores do tipo de enumeração WER_SUBMIT_RESULT .

Valor Significado
WerCustomAction
9		 O relatório de erros pode ser personalizado.
WerDisabled
5		 O relatório de erros foi desabilitado.
WerDisabledQueue
7		 O enfileiramento foi desabilitado.
WerReportAsync
8		 O relatório foi assíncrono.
WerReportCancelled
6		 O relatório foi cancelado.
WerReportDebug
3		 O botão Depurar foi clicado.
WerReportFailed
4		 Falha no envio do relatório.
WerReportQueued
1		 O relatório foi enfileirado.
WerReportUploaded
2		 O relatório foi carregado.

Retornar valor

Essa função retorna S_OK em caso de êxito ou um código de erro em caso de falha.

Comentários

Depois que o aplicativo chama essa função, o WER coleta os dados especificados. Se o parâmetro de consentimento for WerConsentApproved, ele enviará o relatório à Microsoft. Se o consentimento for WerConsentNotAsked, o WER exibirá a caixa de diálogo de consentimento. Para determinar a status de envio, marcar o parâmetro pSubmitResult.

No caso de um evento de aplicativo crítico, os aplicativos que se registraram para reinicialização serão reiniciados.

O identificador do computador é enviado com o relatório quando:

  • O consentimento usado para enviar o relatório não vem do aplicativo. Por exemplo, o relatório foi enviado com consentimento status definido como WerConsentNotAsked.
  • O relatório foi enviado com o sinalizador WER_SUBMIT_REPORT_MACHINE_ID definido.

Para exibir os relatórios enviados pelo seu aplicativo, acesse Windows Quality Online Services.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho werapi.h
Biblioteca Wer.lib
DLL Wer.dll

Confira também

Recuperação e reinicialização do aplicativo, WerReportCreateRelatório de Erros do Windows