[Enterprise Extensions only]

NVList::remove

Overview Deletes the named value associated with the input index.
Original class CORBA::NVList
Exceptions CORBA::SystemException


Intended Usage

The remove method is used by a client program when freeing an element of the NVList associated with a DII request. The remove method deletes the named value associated with the input index. CORBA::release(NamedValue_ptr) is called on the named value element. The remaining named value elements are re-indexed.

IDL Syntax

  CORBA::Status remove(CORBA::Ulong index);

Input parameters

index
The index of the named value to be deleted, starting at zero. A system exception is raised if the input index is greater than or equal to the number of elements in the named value list.

Return values

CORBA::Status
A zero return code indicates the named value was successfully deleted.