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

1.6.1 CORBA_Request_add_arg()

名前

　CORBA_Request_add_arg

形式

　#include <orb.h>
　CORBA_ORBStatus  CORBA_Request_add_arg(
        CORBA_Request  req,
        CORBA_Identifier  name,
        CORBA_TypeCode  arg_type,
        void  *value,
        CORBA_long  len,
        CORBA_Flags  arg_flags,
        CORBA_Environment  *env );
　typedef  CORBA_Object  CORBA_Request;
　typedef  CORBA_string  CORBA_Identifier;
　typedef  CORBA_Object  CORBA_TypeCode;

機能説明

　reqで指定したリクエストオブジェクトに、呼び出すサーバアプリケーション関数のパラメタ情報を追加します。
　パラメタは、最低限valueとlenを指定しなければなりません。arg_type、name、およびarg_flagsは指定しなくてもよいです。
　この関数により、パラメタはリクエストオブジェクトに結び付けられます。
　パラメタをリクエストオブジェクトに結び付けるには、CORBA_Object_create_request()の呼び出しの際に指定する方法もあります。これらの２つの方法を混合することはできません。

パラメタ

　req

CORBA_Object_create_request()で返されるリクエストオブジェクトのオブジェクトリファレンス。

　name

パラメタの名前。

　arg_type

パラメタのTypeCodeオブジェクト。

　value

パラメタのメモリ領域を指すポインタ。

　len

パラメタのメモリ領域の長さ。

　arg_flags

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

　CORBA_ARG_IN

　入力だけのパラメタ。

　CORBA_ARG_OUT

　出力だけのパラメタ。

　CORBA_ARG_INOUT

　入出力パラメタ。

　CORBA_IN_COPY_VALUE

　引数値のコピーが作られ、代わりに使われます。このフラグはCORBA_ARG_INOUTおよびCORBA_ARG_OUTが指定された場合は無視されます。

　env

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

復帰値

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