通过

设备错误代码

  • 项目

InvokeAction 和 QueryStateVariable 方法返回的 HRESULT 值可能指示设备错误 (即从 UPnP 认证的设备收到的错误) 。 如果从设备收到错误，则方法 (InvokeAction 或 QueryStateVariable) 返回基于设备错误代码的 HRESULT 值，如本主题中所述。 由于将转换应用于设备错误代码以生成 HRESULT 值，因此无法直接从 HRESULT 值读取设备错误代码。

将设备错误代码转换为 HRESULT

有标准和非标准设备错误代码。 标准代码在所有 UPnP 认证的设备上具有相同的含义，其值小于 600。 非标准代码特定于供应商，其值范围为 600 到 899。

设备错误代码是否为标准代码决定了 HRESULT 值的生成方式：

  • 标准设备错误代码映射到 HRESULT 值。
  • 通过应用公式，将非标准设备错误代码嵌入到 HRESULT 值中。

这两个过程都可以撤消，以确定特定 HRESULT 值中的设备错误代码。

从 HRESULT 值派生设备错误代码

如果 HRESULT 值大于或等于 UPNP_E_ACTION_SPECIFIC_BASE (0x80040300) 且小于或等于 UPNP_E_ACTION_SPECIFIC_MAX (0x8004042B) ，则设备错误代码为非标准 - 请使用以下部分中的公式来确定错误代码。 否则，设备错误代码为标准 - 请使用“标准设备错误代码映射”部分中的表，该表提供从 HRESULT 值到设备错误代码的映射。

若要在调用 IUPnPService：：InvokeAction 后对错误进行文本说明，请将 pvarRetVal 参数设置为空数组。 返回后，此参数将包含错误的文本说明（如果发生）。

非标准设备错误代码的公式

如果 UPNP_E_ACTION_SPECIFIC_BASE≤HRESULT ≤UPNP_E_ACTION_SPECIFIC_MAX，请使用以下公式。

设备错误代码 = (HRESULT - UPNP_E_ACTION_SPECIFIC_BASE) + FAULT_ACTION_SPECIFIC_BASE

用实际数值替换公式为：设备错误代码 = (HRESULT - 0x80040300) + 0x0258

标准设备错误代码的映射

如果 HRESULT<UPNP_E_ACTION_SPECIFIC_BASE，请使用以下映射。

HRESULT 值 设备错误代码 实际值
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

 

更多信息

设备错误代码在“UPnP 设备体系结构版本 1.0”中指定。 本主题中提到的常量在 Upnp.h 和 Upnp.idl 文件中定义。