ContextList::add_consume

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.

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


Related reference
CORBA module



Searchable topic ID:   rcor_modcl4
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_modcl4.html

Library | Support | Terms of Use | Feedback