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