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

1.2.4 CORBA_Object_create_request()

名前

　CORBA_Object_create_request

形式

　#include <orb.h>
　CORBA_ORBStatus  CORBA_Object_create_request(
        CORBA_Object  obj,
        CORBA_Context  ctx,
        CORBA_Identifier  operation,
        CORBA_NVList  arg_list,
        CORBA_NamedValue  result,
        CORBA_Request  request,
        CORBA_Flags  req_flags,
        CORBA_Environment *env );
　typedef  CORBA_Object  CORBA_Context;
　typedef  CORBA_string  CORBA_Identifier;
　typedef  CORBA_Object  CORBA_NVList;
　typedef  struct  CORBA_NamedValue {
        CORBA_Identifier  name;
        CORBA_any  argument;
        CORBA_long  len;
        CORBA_Flags  arg_modes;
　} CORBA_NamedValue;
　typedef  CORBA_Object  CORBA_Request;

機能説明

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

　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()で返されるNamedValueオブジェクトを指定します。復帰値がvoidの場合は、TC_nullを指定します。resultで指定する NamedValueオブジェクト内のany型変数のTypeCodeには、CORBA_Request_invoke(), CORBA_Request_send()で呼び出すメソッドの復帰値のTypeCodeを設定する必要があります。
　req_flagsには以下のフラグが指定できます。

CORBA_OUT_LIST_MEMORY

　arg_listで指定したリストオブジェクト（NVList）がリクエストオブジェクトに結び付けられます。この場合、arg_listを指定しなければなりません。CORBA_Request_delete()でリクエストを破壊すると自動的にリストオブジェクトも破壊されます。
　CORBA_OUT_LIST_MEMORYが指定されなければ、リストオブジェクトはプログラムが解放するまで利用可能です。解放には、CORBA_free()を使用します。

復帰値

　正常終了した場合は、CORBA_OKが返されます。
　異常終了した場合は、CORBA_FAILEDが返されます。