Context::set_one_value

Overview Adds a single property.
Original class CORBA::Context
Exceptions CORBA::SystemException


Intended Usage

The set_one_value method adds a single property to a context. If the input property name is not found in the property list, a new NamedValue (with the input property name and value) is added. If the input property name is found, the associated NamedValue is removed, then a new NamedValue (with the input property name and value) is added.

Syntax

  CORBA::Status set_one_value(const char *prop_name,
                              const CORBA::Any &value);

Input parameters

prop_name
The name of the property to be added. Context properties follow the rules for OMG IDL identifiers. Property names should not end with an asterisk. If a null pointer is passed for this parameter, a system exception is raised. The caller retains ownership of the input string (the Context makes its own copy).
value
The address of the value of the property to be added. Currently, only strings are supported as property values. It is legal to pass a null pointer. The caller retains ownership of the input Any.

Return values

CORBA::Status
A zero return code indicates the property was successfully added.

Related reference
CORBA module



Searchable topic ID:   rcor_modcx8
Last updated: Jun 21, 2007 8:07:48 PM CDT    WebSphere Business Integration Server Foundation, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.wasee.doc/info/ee/corba/ref/rcor_modcx8.html

Library | Support | Terms of Use | Feedback