[Enterprise Extensions only]

Request::env

Overview Retrieves the client environment associated with a DII request.
Original class CORBA::Request


Intended Usage

The env method is used by a client application to access an exception raised by a Dynamic Invocation Interface (DII) request. The exception is held in a CORBA::Environment object, which is used for error handling in those cases where catch/throw exception handling cannot be used (such as DII). For additional information, see the Environment class description. The Environment object is automatically created by the CORBA::Object::_create_request or CORBA::Object::_request method used to construct the Request object.

IDL Syntax

  CORBA::Environment_ptr env();

Input parameters

None.

Return values

CORBA::Environment_ptr
A pointer to the client environment associated with a DII request. Ownership of the return value is maintained by the Request object; the return value must not be freed by the caller.