Intended Usage
The add_item_consume method is used by a client program to populate the NVList object associated with a DII request. The add_item_consume method adds an element to the end of a named value list. The newly created named value is initialized using the input argument name and flags. The difference between the add_item and add_item_consume methods is that the former does not assume ownership of the input argument name, while the latter does. The caller may not access the memory referred to by the input parameter after it has been passed in. See also the add, add_value, and add_value_consume methods.
Syntax
CORBA::NamedValue_ptr add_item_consume(char *id, CORBA::Flags flags);
Input parameters
Return values