[Enterprise Extensions only]

Request::contexts

Overview Accesses the list of context strings that is sent with a DII request.
Original class CORBA::Request


Intended Usage

The contexts method is used by a client application to access the list of context strings that are sent with a Dynamic Invocation Interface (DII) request, as optionally input to the CORBA::Object::_create_request method. The context list is specified using a CORBA::ContextList object and is used to improve performance. When invoking a request without an associated ContextList object, the ORB looks up context infomation in the Interface Repository. For additional information, see the ContextList class description.

IDL Syntax

  CORBA::ContextList_ptr contexts();

Input parameters

None.

Return values

CORBA::ContextList_ptr
A pointer to the list of context strings that are sent with the DII request, as input to CORBA::Object::_create_request, or a null pointer. Ownership of the return result is maintained by the Request object; the return value must not be freed by the caller.