![]() |
Overview Adds a single property name to a context list. Original class CORBA::ContextList Exceptions CORBA::SystemException
Intended Usage
The add_consume method is used by a client program to populate the ContextList associated with a DII request. The add_consume method adds a single property name to a context list. The add and add_consume methods perform the same task but differ in memory management. The add_consume method assumes ownership of the input property name; the add method does not. The caller must not access the memory referred to by the input parameter after it has been passed in.
IDL Syntax
void add_consume(char *ctxt);
Input parameters
- ctxt
- The name of the property to be added. Property names follow the rules for OMG IDL identifiers and should not end with an asterisk. The property name must be allocated using the CORBA::string_alloc method. Ownership of this parameter transfers to the ContextList. A system exception is raised if the input property name is null.
Return values
None