Ets_Nt_Import_Object_Create_From_Hname()
Note: Requires OPNET Development Kit
Abstract
Creates an object based on a hierarchical name.
Syntax
Ets_Nt_Import_Object_Create_From_Hname (hname, type, model_ptr)
| Argument | Type | Description |
|---|---|---|
hname |
char* |
Hierarchical name of the object to be created. |
type |
EtsT_Nt_Import_Object_Type |
Type of object to be created; must be EtsC_Nt_Object_Type_Node_Fix. |
model_ptr |
EtsT_Nt_Import_Model* |
Import model in which to create the object. |
Return Type
EtsT_Nt_Import_Object*
The newly created object.
Header
ets_nt_obj_import.h
Details
This function can only create objects representing a fixed node. If any other type of object is requested, the function returns PRGC_NIL.
If a site’s parents do not exist when this function is called, any missing ancestor is created as a fixed subnet. For example, assume hname is top.net_a.net_b.my_node. If top.net_a has no net_b child, this function will create net_b as a fixed subnet in top.net_a and place my_node into the resulting subnet.
This function generates a recoverable error if hname is unspecified (NIL pointer or empty string) or if model_ptr is NIL.