WerReportSubmit, fonction (werapi.h)

Envoie le rapport de Rapport d'erreurs Windows (WER) spécifié.

Syntaxe

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

Paramètres

[in] hReportHandle

Handle du rapport. Ce handle est retourné par la fonction WerReportCreate .

[in] consent

Le consentement status. Ce paramètre peut être l’une des valeurs suivantes du type d’énumération WER_CONSENT .

Valeur	Signification
WerConsentAlwaysPrompt 4	L’utilisateur est toujours invité à envoyer la demande.
WerConsentApproved 2	L’utilisateur a approuvé la demande de soumission.
WerConsentDenied 3	L’utilisateur a refusé la demande d’envoi.
WerConsentMax 5	Valeur maximale pour le type d’énumération WER_CONSENT .
WerConsentNotAsked 1	L’utilisateur n’a pas été invité à donner son consentement.

[in] dwFlags

Ce paramètre peut prendre une ou plusieurs des valeurs suivantes.

Valeur	Signification
WER_SUBMIT_ADD_REGISTERED_DATA 16	Ajoutez les données inscrites par WerSetFlags, WerRegisterFile et WerRegisterMemoryBlock au rapport.
WER_SUBMIT_HONOR_RECOVERY 1	Honorez toute inscription de récupération pour l’application. Pour plus d’informations, consultez RegisterApplicationRecoveryCallback.
WER_SUBMIT_HONOR_RESTART 2	Respecter toute inscription de redémarrage pour l’application. Pour plus d’informations, consultez RegisterApplicationRestart.
WER_SUBMIT_NO_ARCHIVE 256	N’archivez pas le rapport.
WER_SUBMIT_NO_CLOSE_UI 64	N’affichez pas la boîte de dialogue fermer pour le rapport critique.
WER_SUBMIT_NO_QUEUE 128	Ne placez pas le rapport en file d’attente. Si le consentement de l’utilisateur est suffisant, le rapport est envoyé immédiatement à Microsoft ; sinon, le rapport est ignoré. Vous pouvez utiliser cet indicateur pour les rapports non critiques. Le rapport est ignoré pour toute action nécessitant la mise en file d’attente du rapport. Par exemple, si l’ordinateur est hors connexion lorsque vous envoyez le rapport, le rapport est ignoré. En outre, si le consentement est insuffisant (par exemple, le consentement était requis pour la partie données du rapport), le rapport est ignoré.
WER_SUBMIT_OUTOFPROCESS 32	Générer un autre processus pour envoyer le rapport. Le thread appelant est bloqué jusqu’à ce que la fonction retourne. NOTE: Les messages de fenêtre seront pompés afin que l’activité de l’interface utilisateur sur le thread appelant ne soit pas bloquée.
WER_SUBMIT_OUTOFPROCESS_ASYNC 1 024	Générez un autre processus pour envoyer le rapport et retourner immédiatement à partir de cet appel de fonction. Notez que le contenu du paramètre pSubmitResult n’est pas défini et qu’il n’existe aucun moyen d’interroger lorsque le rapport est terminé ou que l’achèvement status.
WER_SUBMIT_QUEUE 4	Ajoutez le rapport à la file d’attente WER sans en informer l’utilisateur. Le rapport est mis en file d’attente uniquement. Les rapports (envoi du rapport à Microsoft) se produisent ultérieurement en fonction du niveau de consentement de l’utilisateur.
WER_SUBMIT_SHOW_DEBUG 8	Afficher le bouton de débogage.
WER_SUBMIT_START_MINIMIZED 512	L’interface utilisateur initiale est réduite et clignote.
WER_SUBMIT_BYPASS_DATA_THROTTLING 2 048	Ignorez la limitation des données pour le rapport. Windows 7 ou version antérieure : Ce paramètre n’est pas disponible.
WER_SUBMIT_ARCHIVE_PARAMETERS_ONLY 4096	Archivez uniquement les paramètres ; la cabine est ignorée. Cet indicateur remplace le paramètre WER ConfigureArchive . Windows 7 ou version antérieure : Ce paramètre n’est pas disponible.
WER_SUBMIT_REPORT_MACHINE_ID 8 192	Envoyez toujours l’identificateur d’ordinateur unique 128 bits avec le rapport, quel que soit le consentement avec lequel le rapport a été soumis. Pour plus d’informations, consultez Remarques. Windows 7 ou version antérieure : Ce paramètre n’est pas disponible.

[out, optional] pSubmitResult

Résultat de la soumission. Ce paramètre peut être l’une des valeurs suivantes du type d’énumération WER_SUBMIT_RESULT .

Valeur	Signification
WerCustomAction 9	Le rapport d’erreurs peut être personnalisé.
WerDisabled 5	Le rapport d’erreurs a été désactivé.
WerDisabledQueue 7	La mise en file d’attente a été désactivée.
WerReportAsync 8	Le rapport était asynchrone.
WerReportCancelled 6	Le rapport a été annulé.
WerReportDebug 3	On a cliqué sur le bouton Déboguer.
WerReportFailed 4	Échec de la soumission du rapport.
WerReportQueued 1	Le rapport a été mis en file d’attente.
WerReportUploaded 2	Le rapport a été chargé.

Valeur retournée

Cette fonction retourne S_OK en cas de réussite ou un code d’erreur en cas d’échec.

Remarques

Une fois que l’application a appelé cette fonction, WER collecte les données spécifiées. Si le paramètre de consentement est WerConsentApproved, il envoie le rapport à Microsoft. Si le consentement est WerConsentNotAsked, WER affiche la boîte de dialogue de consentement. Pour déterminer le status d’envoi, case activée le paramètre pSubmitResult.

En cas d’événement d’application critique, les applications qui se sont inscrites pour le redémarrage sont redémarrées.

L’identificateur de l’ordinateur est envoyé avec le rapport dans les cas suivants :

• Le consentement utilisé pour envoyer le rapport ne provient pas de l’application. Par exemple, le rapport a été soumis avec le consentement status défini sur WerConsentNotAsked.
• Le rapport a été soumis avec l’indicateur WER_SUBMIT_REPORT_MACHINE_ID défini.

Pour afficher les rapports envoyés par votre application, accédez à Windows Quality Online Services.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	werapi.h
Bibliothèque	Wer.lib
DLL	Wer.dll

Voir aussi

Récupération et redémarrage d’application, WerReportCreate, Rapport d'erreurs Windows