Ets_Obj_Path_Install_Connect()
摘要
将一条尚未连接的路径连接到一组节点和链路。
语法
Ets_Obj_Path_Install_Connect (installee_path_hndl, circuit_connections_lptr)
| 参数 | 类型 | 说明 |
|---|---|---|
installee_path_hndl |
EtsT_Obj_Handle * |
待安装的路径 |
circuit_connections_lptr |
EtsT_Obj_List * |
路径将要连接到的节点和链路列表。 |
返回类型
EtsT_Compcode
参见详情。
头文件
ets_api_obj.h
详情
使一条当前未与任何模型关联的路径与该模型关联,并连接到电路连接列表中的节点和链路。
节点和链路所属的网络将取得该路径的所有权,因此其他代码不应释放它。
安装之后不会检查电路连通性。
必须满足以下条件:
- 待安装的路径不得属于任何模型。
- 待安装的对象必须是一条路径。
- 连接列表中的所有节点和链路必须来自同一网络模型。
- 连接列表中的元素必须是指向节点或链路对象的指针。
若不满足上述任一条件,返回 EtsC_Compcode_Failure;否则返回 EtsC_Compcode_Success。