Ets_Obj_Reinstall()
摘要
将一个对象从其当前父对象上卸载,并重新安装到新的父对象上。
语法
Ets_Obj_Reinstall (new_parent_obj_hndl, obj_hndl_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
new_parent_obj_hndl |
EtsT_Obj_Handle |
要将对象重新安装到其中的新父对象。 |
obj_hndl_ptr |
EtsT_Obj_Handle * |
目标对象。 |
返回类型
EtsT_Compcode
对象成功重新安装时返回 EtsC_Compcode_Success;否则返回 EtsC_Compcode_Failure。
头文件
ets_api_obj.h
详情
重新安装已连接的对象时,所有链路连接都会相应调整。在该函数执行期间,会为 obj_hndl_ptr 调用对象变更处理程序。
新的父对象(new_parent_obj_hndl)必须是一个子网,必须与某个模型关联,并且不能已经包含与被重新安装对象同名的对象。被重新安装的对象只能是站点或总线链路;不允许非总线链路。
该函数计算量很大。如果要重新安装大量对象,Ets_Obj_Reinstall_List() 可能提供更好的性能。