![]() |
Overview Creates a CORBA::ContextList object. Original class CORBA::ORB Exceptions CORBA::SystemException
Intended Usage
The CORBA::ORB::create_context_list method is intended to be used by client applications using the Dynamic Invocation Interface (DII), to create a CORBA::ContextList object to be subsequently passed to the CORBA::Object::create_request method.
IDL Syntax
CORBA::Status create_context_list (CORBA::ContextList_ptr& cntxt_list);
Input parameters
- cntxt_list
- A pointer for a CORBA::ContextList object, passed by reference, to be initialized by the CORBA::ORB::create_context_list method. The caller assumes ownership of the new ContextList object, but if the caller passes the ContextList to the CORBA::Object::create_request method, ownership of the ContextList is then transferred to the Request object.
Return values
- CORBA::Status
- A zero return code indicates success.
Example
/* The following program creates a CORBA::context list object and generates a system exception if appropriate */ #include "corba.h" #include int main(int argc, char* argv[]) { int rc = 0; CORBA::ContextList_ptr CLptr = CORBA::ContextList::_nil(); /* assume op initialized */ extern CORBA::ORB_ptr op; try { CORBA::Status st = orb->create_context_list(CLptr); } catch (CORBA::SystemException &se) { cout << "exception: " << se.id() << endl; rc="1;" } return rc; }