Context::create_child

Overview Creates a child Context object.
Original class CORBA::Context
Exceptions CORBA::SystemException


Intended Usage

Context objects may be "chained" together to achieve a particular default behavior. Property searches on a child context recursively look in the parent context. The create_child method creates a new child Context object. The child context is chained to the parent context, which is the target object.

Syntax

  CORBA::Status create_child(const char *ctx_name,
                             CORBA::Context_ptr &child_ctx);

Input parameters

ctx_name
The name of the child context to be created, if any, or a null pointer. If specified, the input context name should follow the rules for OMG IDL identifiers. The caller retains ownership of the input name (the Context makes its own copy).
child_ctx
A pointer for a Context object, passed by reference, to be updated by the create_child method to point to the newly created child context. Ownership of this parameter transfers to the caller and must be freed by calling CORBA::release(Context_ptr).

Return values

CORBA::Status
A zero return code indicates the child Context object was successfully created.

Related reference
CORBA module



Searchable topic ID:   rcor_modcx4
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_modcx4.html

Library | Support | Terms of Use | Feedback