[Enterprise Extensions only]

ORB::send_multiple_requests_deferred

Overview Issues multiple deferred requests in parallel.
Original class CORBA::ORB
Exceptions CORBA::SystemException


Intended Usage

The CORBA::ORB::send_multiple_requests_deferred method is intended to be used by client applications that are using the Dynamic Invocation Interface (DII), to issue multiple deferred requests in parallel. The results of these requests can later be obtained using CORBA::ORB::get_next_response. For each CORBA::Request in the input sequence, CORBA::Request::send_deferred is invoked.

IDL Syntax

  CORBA::Status send_multiple_requests_deferred (
    const CORBA::RequestSeq& req_seq);

Input parameters

req_seq
A sequence of CORBA::Request_ptr objects to be invoked. An empty sequence is valid. However, each CORBA::Request_ptr object in the sequence must be non-NULL. The caller retains ownership of this sequence and of the CORBA::Request objects it contains.

Return values

CORBA::Status
A zero return value indicates that all Requests were issued.

Example

  #include "corba.h"
  ...
  /* assume op initialized */
  extern CORBA::ORB_ptr op;
  CORBA::ORB::RequestSeq reqSeq = CORBA::ORB::RequestSeq(1024);
  ... /* prepare each request in reqSeq */
  /* issue multiple deferred requests */
  CORBA::Status rc = op->send_multiple_requests_deferred(reqSeq);
  ...