IWiaAppErrorHandler :: ReportStatus, méthode

Gère l’état des appareils et les messages d’erreur pendant les 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 [ dans]

Type : long

Non utilisé. Définit la valeur 0.

pWiaItem2 [ dans]

Type : IWiaItem2*

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

hrStatus [ dans]

Type : HRESULT

Code d’état de l’appareil.

lPercentComplete [ dans]

Type : long

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

Valeur de retour

Type : HRESULT

Retourne hrStatus si la récupération à partir de l’erreur n’est pas possible. Dans le cas contraire, elle retourne l’une des valeurs suivantes.

Code de retour Description
_OK
Si hrStatus est une erreur, l’action appropriée a été effectuée pour corriger l’erreur et le transfert peut continuer. Si hrStatus est informatif, l’utilisateur a été informé avec une boîte de dialogue non modale et a choisi de ne pas annuler le transfert.
S _ false
L’utilisateur a annulé le transfert à partir de la boîte de dialogue non modale du gestionnaire d’erreurs. Cette valeur peut être retournée à n’importe quel point, quelle que soit la valeur de l’élément hrStatus .
_État WIA _ non _ géré
Aucune action n’a été effectuée ; 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 le suivant : 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 du temps nécessaire à la mise en route. Le paramètre lPercentComplete passé dans IWiaAppErrorHandler :: ReportStatus est la même valeur que le lPercentComplete que le pilote définit dans la structure WiaTransferParams .

Un gestionnaire d’erreurs peut utiliser les macros ayant réussi et échoué pour déterminer si hrStatus a une erreur de gravité _ ou une gravité de gravité _ .

Si le niveau de gravité de la valeur de hrStatus est _ réussite, l’utilisateur doit être autorisé à annuler le transfert.

Si hrStatus est _ une erreur de gravité, le gestionnaire d’erreurs doit afficher une boîte de dialogue modale détenue par la fenêtre parente de l’application.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows [Applications de bureau Vista uniquement]
Serveur minimal pris en charge
Windows Serveur 2008 [ applications de bureau uniquement]
En-tête
WIA. h
MIDL
WIA. idl
Bibliothèque
Wiaguid. lib