Ets_Obj_Hname_Get()
摘要
返回指定对象的层次名称。
语法
Ets_Obj_Hname_Get (obj_hndl, include_top)
| 参数 | 类型 | 说明 |
|---|---|---|
obj_hndl |
EtsT_Obj_Handle |
目标对象的句柄。 |
include_top |
EtsT_Boolean |
指示返回的名称是否应包含 “top”(即形如 “top.<...>.node”)。 |
返回类型
char *
该对象的有效层次名称,或 PRGC_NIL。
头文件
ets_api_obj.h
详情
该函数返回一个新分配的字符串,其中包含 obj_hndl 所指定对象的层次名称(hname)。如果 include_top 为真,hname 将形如 top.subnet_1.<...>.node;否则,hname 将形如 subnet_1.<...>.node。如果 obj_hndl 指定的对象无效或未安装到模型中,或者 obj_hndl 的任一父对象不存在 name 属性,则返回 PRGC_NIL。