Ets_Obj_Reinstall_List()
Abstract
Uninstalls all objects in a list from their current parent object and reinstalls them with a new parent.
Syntax
Ets_Obj_Reinstall_List (new_parent_obj_hndl, site_obj_lptr)
| Argument | Type | Description |
|---|---|---|
new_parent_obj_hndl |
EtsT_Obj_Handle |
New parent object in which to reinstall the listed objects. |
site_obj_lptr |
EtsT_Obj_List * |
List of objects to reinstall. Each item must be of type EtsT_Obj_Handle *. |
Return Type
EtsT_Compcode
EtsC_Compcode_Success if the objects are successfully reinstalled; EtsC_Compcode_Failure otherwise.
Header
ets_api_obj.h
Details
This function provides a faster way of reinstalling large numbers of objects than using Ets_Obj_Reinstall() on each one. Although this function is intended for lists of site objects, it will work with all valid objects.
The new parent (new_parent_obj_hndl) must be a subnet, must be associated with a model, and must not already contain objects with the same names as those being reinstalled.
All link connections are adjusted accordingly when attached objects are reinstalled. The object change handler is called for each object in site_obj_lptr during execution of this function.