1.6.1 CORBA_Request_add

名前

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が返されます。

1.6.1 CORBA_Request_add_arg()