CORBA API

CORBA Programming Reference

CORBA::NVList::add_item

Synopsis

Constructs a NamedValue object, creating an empty value attribute and initializing the name and flags attributes.

C++ Binding

CORBA::NamedValue_ptr CORBA::NVList::add_item (
     const char *    Name,
     CORBA::Flags    Flags);

Arguments

Name

The name of the list item.

Flags

Flags to determine argument passing. Valid values are:

           CORBA::ARG_IN 
           CORBA::ARG_INOUT 
           CORBA::ARG_OUT

Description

This member function constructs a NamedValue object, creating an empty value attribute and initializing the name and flags attributes that pass in as parameters. The NamedValue object is added to the NVList object that the call was invoked upon.

The NVList object grows dynamically; your application does not need to track its size.

Return Values

If the function succeeds, the return value is a pointer to the newly created NamedValue object. The returned NamedValue object reference is owned by the NVList and should not be released.

If the member function does not succeed, an exception is thrown.