[Enterprise Extensions only]

ExceptionList::add_consume

Overview Adds a single user-defined exception to an exception list.
Original class CORBA::ExceptionList
Exceptions CORBA::SystemException


Intended Usage

The add_consume method is used by a client program to populate the ExceptionList associated with a DII request. The add_consume method adds a single user-defined exception to an exception list. The add and add_consume methods perform the same task but differ in memory management. The add_consume method assumes ownership of the input TypeCode; the add method does not. The caller must not access the object referred to by the input parameter after it has been passed in.

IDL Syntax

  void add_consume(CORBA::TypeCode_ptr tc);

Input parameters

tc
A pointer to the TypeCode for the user-defined exception. The input TypeCode must either be retrieved from the Interface Repository or allocated using the ORB::create_exception_tc method. Ownership of this parameter transfers to the ExceptionList. A system exception is raised if the input pointer to the TypeCode is null.

Return values

None.