Ets_Obj_Qualified_Hname_Get()
Abstract
Returns a hierarchical name for an object that is unique across all namespaces.
Syntax
Ets_Obj_Qualified_Hname_Get (obj_hndl)
| Argument | Type | Description |
|---|---|---|
obj_hndl |
EtsT_Obj_Handle |
Object for which to generate a qualified hierarchical name. |
Return Type
char *
Fully qualified name string, or OPC_NIL if unsuccessful (for example, if the object has no valid namespace).
Header
ets_api_obj.h
Details
This function creates a unique hierarchical name for the specified object by concatenating the object's hname with a prefix that denotes the namespace (for example, a node's qualified name might be Node.top.subnet_0.node_1). The prefix used is the same string returned by Ets_Obj_Type_Namespace_Get().
The returned string is owned by the caller and should be destroyed with prg_string_free() when no longer needed.