文档首页/ IoT物联网/ SDK参考/ 设备侧Agent Lite API参考(C)（联通用户专用）/ 非直连设备管理/ 删除设备
更新时间：2024-07-01 GMT+08:00
查看PDF
分享

删除设备

接口功能

当有新设备需要从网关移除时，通过调用设备删除接口将非直连设备从物联网平台删除。

接口描述

1
 
HW_INT IOTA_HubDeviceRemove(HW_UINT uiCookie, const HW_CHAR *pcDeviceId);

参数说明

字段

必选/可选

类型

描述

uiCookie

可选

HW_UINT

Cookie有效值1-65535。

pcDeviceId

必选

String

设备Id，该参数必须带结束符‘\0'。

接口返回值

参见函数标准返回值

返回结果

广播名称

广播参数

成员

描述

IOTA_TOPIC_HUB_RMVDEV_RSP

HW_MSG对象

EN_IOTA_HUB_IE_TYPE

删除结果。

EN_IOTA_HUB_IE_TYPE：

枚举项

枚举值

类型

描述

EN_IOTA_HUB_IE_RESULT

0

EN_IOTA_HUB_RESULT_TYPE

添加/删除执行结果。

EN_IOTA_HUB_IE_DEVICEID

1

String

添加成功后分配的设备ID。

EN_IOTA_HUB_RESULT_TYPE：

枚举项

枚举值

描述

EN_IOTA_HUB_RESULT_SUCCESS

0

添加/删除执行成功。

EN_IOTA_HUB_RESULT_DEVICE_EXIST

1

设备已存在。

EN_IOTA_HUB_RESULT_DEVICE_NOTEXIST

2

设备不存在。

EN_IOTA_HUB_RESULT_DEVICE_FAILED

255

执行失败。

示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
 
// 开发者调用该接口进行设备删除 
HW_cHAR *pcDeviceId = stDevice.pcDeviceId;
IOTA_HubDeviceRemove(HW_NULL, pcDeviceId);
结果处理： 
HW_iNT Device_RemoveResultHandler(HW_UiNT uiCookie, HW_MSG pstMsg) 
{
    uiResult = HW_MsgGetUint (pstMsg, EN_IOTA_HUB_IE_RESULT);
    if (EN_IOTA_HUB_RESULT_SUCCESS != uiResult) 
    {
        // retry with uiCookie 
        return 0;
    }
    return 0;
}
HW_BroadCastReg(“IOTA_TOPIC_HUB_RMVDEV_RSP”, Device_RemovResultHandler);
父主题： 非直连设备管理

相关文档