Ets_Obj_Qualified_Hname_Get()
摘要
返回一个在所有命名空间中均唯一的对象层次名称。
语法
Ets_Obj_Qualified_Hname_Get (obj_hndl)
| 参数 | 类型 | 说明 |
|---|---|---|
obj_hndl |
EtsT_Obj_Handle |
要生成限定层次名称的对象。 |
返回类型
char *
完全限定名称字符串;失败时返回 OPC_NIL(例如该对象没有有效的命名空间)。
头文件
ets_api_obj.h
详情
该函数通过将对象的 hname 与表示命名空间的前缀拼接,为指定对象创建一个唯一的层次名称(例如,节点的限定名称可能是 Node.top.subnet_0.node_1)。所使用的前缀与 Ets_Obj_Type_Namespace_Get() 返回的字符串相同。
返回的字符串归调用者所有,不再需要时应使用 prg_string_free() 销毁。