Ovis_Entity_From_Objid_Get()
摘要
使用站点的对象 ID 检索 Ovis 实体。
语法
Ovis_Entity_From_Objid_Get (des_objid, options)
| 参数 | 类型 | 说明 |
|---|---|---|
des_objid |
Objid |
对象 ID |
options |
int |
指定选项(参见详情) |
返回类型
OvisT_Entity *
返回该实体,或返回 OVISC_NIL。
头文件
ovis_entity.h
详情
该函数使用被仿真对象的 ID 检索与之关联的 Ovis 实体。
如果 options 为 OVISC_ENTITY_FROM_SITE_ONLY,该函数使用站点的对象句柄检索与站点关联的 Ovis 实体。若该站点不存在实体,函数返回 OVISC_NIL。
如果 options 为 OVISC_ENTITY_FROM_SITE_OR_PARENTS,该函数还会查看父子网是否存在关联的实体。检索在第一个拥有实体的祖先处停止。
示例
OvisT_Entity * ent_ptr;
/* Look for entity associated with node containing that process model */
ent_ptr = Ovis_Entity_From_Objid_Get (op_topo_parent (op_id_self ()),
OVISC_ENTITY_FROM_SITE_ONLY);
错误
- 对象 ID(
<id>)超出范围。 - 对象 ID(
<id>)指向受限对象。 - 对象
<hname>不是固定节点、移动节点或子网。
参考
- 使用函数
Ovis_Entity_From_Objid_Create()基于所提供的对象 ID 创建实体。