Ovis_Entity_From_Hname_Get()
摘要
根据站点的完整层次名称获取 Ovis 实体。
语法
Ovis_Entity_From_Hname_Get (hname)
| 参数 | 类型 | 说明 |
|---|---|---|
hname |
const char * |
站点的完整层次名称。 |
返回类型
OvisT_Entity *
返回该实体;若函数未能返回实体则返回 OVISC_NIL。
头文件
ovis_entity.h
详情
该函数接收对象的完整层次名称,并返回与该站点关联的 Ovis 实体(如果存在)。如果层次名称不对应任何站点(节点或子网),或该站点未与任何实体关联,则函数返回 OVISC_NIL。
示例
OvisT_Entity * ent_ptr;
/* Entity was created at some point */
ent_ptr Ovis_Entity_From_Hname_Get ("top.subnet.chopper");
错误
- 提供的层次名称参数无效。
- 没有对象与提供的层次名称(
<name>)匹配。 - 对象(
<name>)不是固定或移动节点或子网。
参考
- 无