Ets_Obj_Reinstall_List()
摘要
将列表中的所有对象从其当前父对象上卸载,并重新安装到新的父对象上。
语法
Ets_Obj_Reinstall_List (new_parent_obj_hndl, site_obj_lptr)
| 参数 | 类型 | 说明 |
|---|---|---|
new_parent_obj_hndl |
EtsT_Obj_Handle |
要将列表中的对象重新安装到其中的新父对象。 |
site_obj_lptr |
EtsT_Obj_List * |
要重新安装的对象列表。每个条目必须是 EtsT_Obj_Handle * 类型。 |
返回类型
EtsT_Compcode
对象成功重新安装时返回 EtsC_Compcode_Success;否则返回 EtsC_Compcode_Failure。
头文件
ets_api_obj.h
详情
与对每个对象分别调用 Ets_Obj_Reinstall() 相比,该函数提供了重新安装大量对象的更快方式。虽然该函数面向站点对象列表,但它适用于所有有效对象。
新的父对象(new_parent_obj_hndl)必须是一个子网,必须与某个模型关联,并且不能已经包含与被重新安装对象同名的对象。
重新安装已连接的对象时,所有链路连接都会相应调整。在该函数执行期间,会为 site_obj_lptr 中的每个对象调用对象变更处理程序。