Códigos de error del dispositivo
Los métodos InvokeAction y QueryStateVariable devuelven valores HRESULT que podrían indicar un error de dispositivo (es decir, un error que se recibe de un dispositivo certificado por UPnP). Si se recibe un error de un dispositivo, el método (InvokeAction o QueryStateVariable) devuelve un valor HRESULT basado en el código de error del dispositivo, como se explica en este tema. Dado que se aplica una conversión al código de error del dispositivo para generar un valor HRESULT , no se puede leer el código de error del dispositivo directamente desde el valor HRESULT .
Conversión de un código de error de dispositivo a UN HRESULT
Hay códigos de error de dispositivo estándar y no estándar. Los códigos estándar tienen el mismo significado en todos los dispositivos certificados por UPnP y tienen valores inferiores a 600. Los códigos no estándar son específicos del proveedor y tienen valores comprendidos entre 600 y 899.
Si el código de error del dispositivo es estándar determina cómo se genera el valor HRESULT :
- Un código de error de dispositivo estándar se asigna a un valor HRESULT .
- Un código de error de dispositivo no estándar se inserta en el valor HRESULT aplicando una fórmula.
Ambos procedimientos se pueden invertir para determinar el código de error del dispositivo a partir de un valor HRESULT determinado.
Derivar un código de error de dispositivo a partir de un valor HRESULT
Si el valor HRESULT es mayor o igual que UPNP_E_ACTION_SPECIFIC_BASE (0x80040300) y menor o igual que UPNP_E_ACTION_SPECIFIC_MAX (0x8004042B), el código de error del dispositivo no es estándar, use la fórmula de la sección siguiente para determinar el código de error. De lo contrario, el código de error del dispositivo es estándar: use la tabla de la sección Mapping for Standard Device Error Codes (Asignación de códigos de error de dispositivo estándar), que proporciona la asignación del valor HRESULT al código de error del dispositivo.
Para obtener una descripción de texto del error después de una llamada a IUPnPService::InvokeAction, establezca el parámetro pvarRetVal en una matriz vacía. Tras la devolución, este parámetro contendrá una descripción de texto del error, si se ha producido alguno.
Fórmula para códigos de error de dispositivo no estándar
Use la fórmula siguiente si UPNP_E_ACTION_SPECIFIC_BASE ≤ ≤ HRESULTUPNP_E_ACTION_SPECIFIC_MAX.
Código de error del dispositivo = (HRESULT - UPNP_E_ACTION_SPECIFIC_BASE) + FAULT_ACTION_SPECIFIC_BASE
Sustituyendo los valores numéricos reales, la ecuación es: Código de error del dispositivo = (HRESULT - 0x80040300) + 0x0258
Asignación de códigos de error de dispositivo estándar
Use la siguiente asignación si HRESULT<UPNP_E_ACTION_SPECIFIC_BASE.
| Valor HRESULT | Código de error del dispositivo | Valor real |
|---|---|---|
| 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 |
Más información
Los códigos de error del dispositivo se especifican en "UPnP Device Architecture version 1.0". Las constantes mencionadas en este tema se definen en los archivos Upnp.h y Upnp.idl.