Interstage Application Server リファレンスマニュアル（API編）

2.3.4 CORBA::Object::_create_request()

名前

　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 );

機能説明

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

　ctxには、CORBA::Context::create_child()で返されるContextオブジェクトまたはCORBA_OBJECT_NIL、operationにはオペレーション名を指定します。arg_listには、CORBA::ORB::create_list()またはCORBA::ORB::create_operation_list()で返されるリストオブジェクトを指定します。パラメタがない場合は、TC_nullを指定します。

　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を設定する必要があります。

req_flagsには以下のフラグが指定できます。
　CORBA::OUT_LIST_MEMORY

　arg_listで指定したリストオブジェクト（NVList）がリクエストオブジェクトに結び付けられます。この場合、arg_listを指定しなければなりません。

　CORBA::OUT_LIST_MEMORYが指定されなければ、リストオブジェクトはプログラムが解放するまで利用可能です。

復帰値

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