Ets_Obj_Reinstall()
Abstract
Uninstalls an object from its current parent object and reinstalls it with a new parent.
Syntax
Ets_Obj_Reinstall (new_parent_obj_hndl, obj_hndl_ptr)
| Argument | Type | Description |
|---|---|---|
new_parent_obj_hndl |
EtsT_Obj_Handle |
New parent object in which to reinstall the object. |
obj_hndl_ptr |
EtsT_Obj_Handle * |
Object of interest. |
Return Type
EtsT_Compcode
EtsC_Compcode_Success if the object is successfully reinstalled; EtsC_Compcode_Failure otherwise.
Header
ets_api_obj.h
Details
All link connections are adjusted accordingly when attached objects are reinstalled. The object change handler is called for obj_hndl_ptr during execution of this function.
The new parent (new_parent_obj_hndl) must be a subnet, must be associated with a model, and must not already contain an object with the same name as the one being reinstalled. The object being reinstalled must be a site or bus link only; non-bus links are not allowed.
This function is computationally intense. If you will be reinstalling large numbers of objects, Ets_Obj_Reinstall_List() might provide better performance.