Méthode IWiaAppErrorHandler::ReportStatus

Article
06/13/2023

Gère les messages d’status et d’erreur de l’appareil lors des transferts de données d’image et affiche les messages à l’utilisateur.

Syntaxe

HRESULT ReportStatus(
  [in] LONG      lFlags,
  [in] IWiaItem2 *pWiaItem2,
  [in] HRESULT   hrStatus,
  [in] LONG      lPercentComplete
);

Paramètres

lFlags [in]

Type : LONG

Non utilisé. Définit la valeur 0.

pWiaItem2 [in]

Type : IWiaItem2*

Pointeur vers l’élément en cours de transfert.

hrStatus [in]

Type : HRESULT

Code status de l’appareil.

lPercentComplete [in]

Type : LONG

Pourcentage terminé de l’opération en cours.

Valeur retournée

Type : HRESULT

Retourne hrStatus si la récupération de l’erreur n’est pas possible. Sinon, elle retourne l’une des valeurs suivantes.

Code de retour	Description
S_OK	Si hrStatus est une erreur, l’action appropriée a été prise pour corriger l’erreur et le transfert peut continuer. Si hrStatus est informatif, l’utilisateur a été informé avec une boîte de dialogue sans mode et a choisi de ne pas annuler le transfert.
S_FALSE	L’utilisateur a annulé le transfert de la boîte de dialogue sans mode du gestionnaire d’erreurs. Cette valeur peut être retournée à tout moment, quel que soit hrStatus .
WIA_STATUS_NOT_HANDLED	Aucune mesure n’a été prise; autrement dit, aucune boîte de dialogue n’a été présentée à l’utilisateur. Le gestionnaire d’erreurs suivant sera appelé. L’ordre des gestionnaires d’erreurs est : application, pilote et système par défaut.

Notes

Le paramètre lPercentComplete permet à une fenêtre de gestionnaire d’erreurs d’afficher la progression. Par exemple, un pilote peut fournir une estimation de la durée d'« échauffement ». Le paramètre lPercentComplete passé dans IWiaAppErrorHandler::ReportStatus a la même valeur que lPercentComplete que le pilote définit dans la structure WiaTransferParams .

Un gestionnaire d’erreurs peut utiliser les macros SUCCEEDED et FAILED pour déterminer si hrStatus a SEVERITY_ERROR ou SEVERITY_SUCCESS.

Si hrStatus est SEVERITY_SUCCESS, l’utilisateur doit être autorisé à annuler le transfert.

Si hrStatus est SEVERITY_ERROR, le gestionnaire d’erreurs doit afficher une boîte de dialogue modale appartenant à la fenêtre parente de l’application.

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]
En-tête	Wia.h
IDL	Wia.idl
Bibliothèque	Wiaguid.lib

Partager via