![]() |
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.
IDL 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.