2.3.4 CORBA::Object::_create

名前

CORBA::Object::_create_request

形式

#include <orb_cplus.h>
CORBA::Status  CORBA::Object::_create_request(
        Context_ptr            ctx,
        const char             *operation,
        CORBA::NVList_ptr      arg_list,
        CORBA::NamedValue_ptr  result,
        CORBA::Request_ptr     &request,
        Flags                  req_flags,
        CORBA::Environment&    env );

機能説明

指定した各引数で初期化されたRequestオブジェクトを生成します。

パラメタ

ctx: CORBA::Context::create_child()で返されるContextオブジェクトまたはCORBA_OBJECT_NILを指定します。

operation: サーバアプリケーションを呼び出すメソッド名。

arg_list: CORBA::ORB::create_list()、またはCORBA::ORB::create_operation_list()で返されるNVListオブジェクト。

result: CORBA::NVList::add_item()、CORBA::NVList::add_value()で返されるNamedValueオブジェクトを指定します。NamedValueオブジェクトのany型変数のTypeCodeには、CORBA::Request::invoke()やCORBA::Request;;send_oneway()、CORBA::Request::send_deferred()で呼び出すメソッドの復帰値のTypeCodeを設定する必要があります。

request: リクエストオブジェクトのオブジェクトリファレンスを設定します。CORBAクライアントは、RequestクラスのCORBA::Request::invoke()やCORBA::Request::send_oneway()、CORBA::Request:: send_deferred()の呼び出し時に、このオブジェクトリファレンスを指定する必要があります。

req_flags

以下のフラグが指定できます。

CORBA::OUT_LIST_MEMORY: arg_listで指定したリストオブジェクト（NVList）がリクエストオブジェクトに結び付けられます。この場合、arg_listを指定しなければなりません。
CORBA::OUT_LIST_MEMORYが指定されなければ、リストオブジェクトはプログラムが解放するまで利用可能です。

env: 例外情報が格納される構造体。

復帰値

正常終了した場合は、CORBA::OKが返され、requestにリクエストオブジェクトのオブジェクトリファレンスが設定されます。
異常終了した場合は、CORBA::FAILEDが返されます。

2.3.4 CORBA::Object::_create_request()