[Enterprise Extensions only]

Context::set_values

Overview Adds one or more properties.
Original class CORBA::Context
Exceptions CORBA::SystemException


Intended Usage

The set_values method adds one or more properties to a context. If an input property names is not found in the property list, a new NamedValue (wtih the input property name and value) is added. If the input property name is found, the associated NamedValue is removed, then a new NamedValue (wtih the input property name and value) is added.

IDL Syntax

  CORBA::Status set_values(CORBA::NVList_ptr values);

Input parameters

values
A pointer to an NVList containing the properties to be set. Context properties follow the rules for OMG IDL identifiers. The property names should not end with an asterisk. Property names must be non-null, or a system exception is raised. Currently, only strings are supported as property values. It is legal to pass a null property value. In the NVList, the flags field must be set to zero. The caller retains ownership of this parameter.

Return values

CORBA::Status
A zero return code indicates the properties were successfully added.