Ets_Nt_Subnet_Slice_Insert()
Note: Requires OPNET Development Kit
Abstract
Inserts an already created slice into a subnet.
Syntax
Ets_Nt_Subnet_Slice_Insert (subnet_hndl, EtsT_Slice_Handle slice_hndl, int insert_position)
| Argument | Type | Description |
|---|---|---|
subnet_hndl |
EtsT_Obj_Handle |
Handle of the subnet in which to insert the slice. |
slice_hndl |
EtsT_Slice_Handle |
Handle of the slice to insert. |
insert_position |
int |
Position in the subnet at which to insert the slice. |
Return Type
EtsT_Compcode
EtsC_Compcode_Success if the slice is inserted successfully. EtsC_Compcode_Failure if either the subnet handle or slice handle is invalid.
Header
ets_api_nt.h
Details
The slice to insert must have been created previously, using Ets_Slice_For_Shapeset_Create(). Insert positions are numbered back to front, with 0 being the backmost position. If insert_position is less than 0, the slice is inserted at position 0. If insert_position is greater than the pre-insertion slice stack size, the slice is appended at the tail (the frontmost position). If the operation completes successfully, the specified subnet takes over slice ownership. Do not call Ets_Slice_Destroy() for such slices; you must remove them first using Ets_Shapeset_Shape_Nth_Remove().