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 |
|---|---|
|
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. |
|
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 . |
|
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 |
|
| MIDL |
|
| Bibliothèque |
|