Ets_Topo_Assoc_Get()
摘要
返回在指定方向上与引用对象相关联的指定类型中按索引指定的对象的句柄。
语法
Ets_Topo_Assoc_Get (reference_obj_hndl, dir, assoc_mtype, assoc_obj_index)
| 参数 | 类型 | 说明 |
|---|---|---|
reference_obj_hndl |
EtsT_Obj_Handle |
引用对象的句柄。 |
dir |
EtsT_Topo_Assoc_Dir |
指定关联方向的值(可能的取值参见 Topology Package 符号常量)。 |
assoc_mtype |
“EtsT_Obj_Type“ |
指定关联对象类型或元类型的值(取自 表 33 “General Sub-Package Symbolic Constants”(第 1046 页) 中的值之一)。 |
assoc_obj_index |
int |
指定要返回哪一个关联对象的索引。 |
返回类型
EtsT_Obj_Handle
指定方向上与引用对象相关联的对象的句柄;若不存在则为 NULL。
头文件
ets_api_topo.h
详情
此函数返回与指定引用对象相关联的对象的句柄(关于关联如何确定,参见关联)。若不存在满足要求的关联对象,则返回 NULL(例如,点需求可能没有目的端)。
assoc_mtype 参数可以是具体的对象类型(如 EtsC_Obj_Type_Node_Fix),也可以是通用的对象元类型(例如 EtsC_Obj_Mtype_Link)。
assoc_obj_index 参数必须是介于零(含)与 Ets_Topo_Assoc_Count_Get() 以相同的引用对象和相同的对象类型调用时返回的计数值(不含)之间的值。