IPhotoAcquireProgressCB ::ErrorAdvise, méthode (photoacquire.h)

Article
03/01/2024

La ErrorAdvise méthode fournit une gestion personnalisée des erreurs qui se produisent pendant l’acquisition. L’application fournit l’implémentation de la ErrorAdvise méthode .

Syntaxe

HRESULT ErrorAdvise(
  [in]  HRESULT                   hr,
  [in]  LPCWSTR                   pszErrorMessage,
  [in]  ERROR_ADVISE_MESSAGE_TYPE nMessageType,
  [out] ERROR_ADVISE_RESULT       *pnErrorAdviseResult
);

Paramètres

[in] hr

Spécifie l’erreur qui s’est produite.

[in] pszErrorMessage

Pointeur vers une chaîne terminée par null contenant le message d’erreur.

[in] nMessageType

Valeur entière contenant le type de message. Il peut s’agir de l’un des éléments suivants.

Valeur	Description
PHOTOACQUIRE_ERROR_SKIPRETRYCANCEL	Spécifie que l’erreur qui s’est produite nécessite une réponse Ignorer, Réessayer ou Annuler. Le paramètre pnErrorAdviseResult doit être défini sur l’une des valeurs suivantes : PHOTOACQUIRE_RESULT_SKIP, PHOTOACQUIRE_RESULT_SKIP_ALL, PHOTOACQUIRE_RESULT_RETRY ou PHOTOACQUIRE_RESULT_ABORT.
PHOTOACQUIRE_ERROR_RETRYCANCEL	Spécifie que l’erreur qui s’est produite nécessite une réponse Réessayer ou Annuler. Le paramètre pnErrorAdviseResult doit être défini sur l’une des valeurs suivantes : PHOTOACQUIRE_RESULT_RETRY ou PHOTOACQUIRE_RESULT_ABORT.
PHOTOACQUIRE_ERROR_YESNO	Spécifie que l’erreur qui s’est produite nécessite une réponse Oui ou Non. Le paramètre pnErrorAdviseResult doit être défini sur l’une des valeurs suivantes : PHOTOACQUIRE_RESULT_YES ou PHOTOACQUIRE_RESULT_NO.
PHOTOACQUIRE_ERROR_OK	Spécifie que l’erreur qui s’est produite nécessite une réponse OK. Le paramètre pnErrorAdviseResult doit être défini sur PHOTOACQUIRE_RESULT_OK.

[out] pnErrorAdviseResult

Pointeur vers une valeur entière contenant le résultat de conseil d’erreur. Le résultat doit être l’un des types acceptables indiqués par le paramètre nMessageType et doit être l’un des suivants :

Valeur	Description
PHOTOACQUIRE_RESULT_YES	Spécifie une réponse Oui. Valide si nMessageType est PHOTOACQUIRE_ERROR_YESNO.
PHOTOACQUIRE_RESULT_NO	Spécifie une réponse No. Valide si nMessageType est PHOTOACQUIRE_ERROR_YESNO.
PHOTOACQUIRE_RESULT_OK	Spécifie une réponse OK. Valide si nMessageType est PHOTOACQUIRE_ERROR_OK.
PHOTOACQUIRE_RESULT_SKIP	Spécifie une réponse Skip. Valide si nMessageType est PHOTOACQUIRE_ERROR_SKIPRETRYCANCEL.
PHOTOACQUIRE_RESULT_SKIP_ALL	Spécifie une réponse Ignorer tout. Valide si nMessageType est PHOTOACQUIRE_ERROR_SKIPRETRYCANCEL.
PHOTOACQUIRE_RESULT_RETRY	Spécifie une réponse de nouvelle tentative. Valide si nMessageType est PHOTOACQUIRE_ERROR_SKIPRETRYCANCEL ou PHOTOACQUIRE_ERROR_RETRYCANCEL.
PHOTOACQUIRE_RESULT_ABORT	Spécifie une réponse Cancel. Valide si nMessageType est PHOTOACQUIRE_ERROR_SKIPRETRYCANCEL ou PHOTOACQUIRE_ERROR_RETRYCANCEL.

Valeur retournée

Cette méthode retourne un code HRESULT. Votre implémentation n’est pas limitée aux valeurs de retour suivantes. Tout HRESULT défaillant autre que E_NOTIMPL est fatal et entraîne l’abandon du transfert.

Code de retour	Description
S_OK	S_OK
E_NOTIMPL	La méthode n’est pas encore implémentée

Remarques

Normalement, un message s’affiche lorsqu’une erreur se produit lors de l’acquisition d’image. Si la suppression de ce message est souhaitée, implémentez ErrorAdvise.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	photoacquire.h
Bibliothèque	PhotoAcquireUID.lib

Voir aussi

IPhotoAcquireProgressCB, interface