Codes d’erreur de l’appareil

Les méthodes InvokeAction et QueryStateVariable retournent des valeurs HRESULT qui peuvent indiquer une erreur d’appareil (c’est-à-dire une erreur reçue d’un appareil certifié UPnP). Si une erreur est reçue d’un appareil, la méthode (InvokeAction ou QueryStateVariable) retourne une valeur HRESULT basée sur le code d’erreur de l’appareil, comme expliqué dans cette rubrique. Étant donné qu’une conversion est appliquée au code d’erreur de l’appareil pour produire une valeur HRESULT , vous ne pouvez pas lire le code d’erreur de l’appareil directement à partir de la valeur HRESULT .

Conversion d’un code d’erreur d’appareil en HRESULT

Il existe des codes d’erreur d’appareil standard et non standard. Les codes standard ont la même signification pour tous les appareils certifiés UPnP et ont des valeurs inférieures à 600. Les codes non standard sont spécifiques au fournisseur et ont des valeurs comprises entre 600 et 899.

Si le code d’erreur de l’appareil est standard ou non, détermine la façon dont la valeur HRESULT est générée :

• Un code d’erreur d’appareil standard est mappé à une valeur HRESULT .

• Un code d’erreur d’appareil non standard est incorporé dans la valeur HRESULT en appliquant une formule.

Ces deux procédures peuvent être inversées pour déterminer le code d’erreur de l’appareil à partir d’une valeur HRESULT particulière.

Dérivation d’un code d’erreur d’appareil à partir d’une valeur HRESULT

Si la valeur HRESULT est supérieure ou égale à UPNP_E_ACTION_SPECIFIC_BASE (0x80040300) et inférieure ou égale à UPNP_E_ACTION_SPECIFIC_MAX (0x8004042B), le code d’erreur de l’appareil est non standard. Utilisez la formule de la section suivante pour déterminer le code d’erreur. Sinon, le code d’erreur de l’appareil est standard. Utilisez le tableau de la section Mappage des codes d’erreur d’appareil standard, qui fournit le mappage de la valeur HRESULT au code d’erreur de l’appareil.

Pour obtenir une description textuelle de l’erreur après un appel à IUPnPService::InvokeAction, définissez le paramètre pvarRetVal sur un tableau vide. Au retour, ce paramètre contient une description textuelle de l’erreur, le cas échéant.

Formule pour les codes d’erreur d’appareil non standard

Utilisez la formule suivante si UPNP_E_ACTION_SPECIFIC_BASE ≤ hresult ≤UPNP_E_ACTION_SPECIFIC_MAX.

Code d’erreur de l’appareil = (HRESULT - UPNP_E_ACTION_SPECIFIC_BASE) + FAULT_ACTION_SPECIFIC_BASE

En remplaçant les valeurs numériques réelles, l’équation est : Device Error Code = (HRESULT - 0x80040300) + 0x0258

Mappage pour les codes d’erreur d’appareil standard

Utilisez le mappage suivant si HRESULT<UPNP_E_ACTION_SPECIFIC_BASE.

Valeur HRESULT	Code d’erreur de l’appareil	Valeur réelle
UPNP_E_INVALID_ACTION	FAULT_INVALID_ACTION	401
UPNP_E_INVALID_ARGUMENTS	FAULT_INVALID_ARG	402
UPNP_E_OUT_OF_SYNC	FAULT_INVALID_SEQUENCE_NUMBER	403
UPNP_E_INVALID_VARIABLE	FAULT_INVALID_VARIABLE	404
UPNP_E_ACTION_REQUEST_FAILED	FAULT_DEVICE_INTERNAL_ERROR	501

 

Informations complémentaires

Les codes d’erreur de l’appareil sont spécifiés dans « UPnP Device Architecture version 1.0 ». Les constantes mentionnées dans cette rubrique sont définies dans les fichiers Upnp.h et Upnp.idl.