IWiaErrorHandler::ReportStatus, méthode

Article
06/13/2023

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

Syntaxe

HRESULT ReportStatus(
  [in] HWND     hwndParent,
  [in] IUnknown *punkItem,
  [in] HRESULT  hrStatus,
  [in] LONG     cbResLength,
  [in] BYTE     *pbData
);

Paramètres

hwndParent [in]

Type : HWND

HWND qui est la fenêtre parente de la fenêtre de message.

punkItem [in]

Type : IUnknown*

Pointeur vers l’interface IUnknown de l’élément en cours de transfert. Cet objet implémente au minimum IWiaItem2 et IWiaDataTransfer.

hrStatus [in]

Type : HRESULT

HRESULT qui est le code status reçu par BandedDataCallback.

cbResLength [in]

Type : LONG

LONG qui correspond à la taille des données référencées par pbData.

pbData [in]

Type : BYTE*

Pointeur vers la mémoire tampon de données reçue par BandedDataCallback.

Valeur retournée

Type : HRESULT

Retourne hrStatus si l’erreur ne peut pas être récupérée. Sinon, elle retourne l’une des valeurs suivantes.

Code de retour	Description
S_OK	L’action appropriée a été prise pour corriger l’erreur et le transfert peut continuer.
S_FALSE	Aucune action n’a été prise pour gérer l’erreur ou le rapport status à l’utilisateur.
E_ABORT	L’utilisateur a choisi d’abandonner le transfert en réponse à la boîte de dialogue affichée.

Notes

Windows Image Acquisition (WIA) 2.0 appelle IWiaErrorHandler::ReportStatus lorsque le pilote envoie un message IT_MSG_DEVICE_STATUS à BandedDataCallback. Cette méthode gère le message et affiche à l’utilisateur des informations sur le status ou l’erreur. Si le message concerne une erreur, la méthode permet à l’utilisateur de choisir, si possible, d’essayer de récupérer après l’erreur et de poursuivre le transfert ou d’abandonner.

hrStatus est défini sur WIA_STATUS_TRANSFER_BEGIN pour informer le gestionnaire qu’un transfert a démarré. Il est défini sur WIA_STATUS_TRANSFER_END lorsque le transfert est terminé.

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

Spécifications

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