8.2.8 動的インタフェースでのパラメタの獲得／解放

動的起動インタフェース（DII）を使用して動的にパラメタを作成する方法について説明します。
パラメタは、CORBA_NVList_add_item()で設定します。

inパラメタ

サーバアプリケーションにinパラメタを渡す場合は、クライアントアプリケーションでパラメタ領域を獲得し、そのポインタをCORBA_NVList_add_item()の第4パラメタに指定します。

CORBA_NVList_add_item(
      arg_list, 
      name,                        /* IDLで指定したパラメタの名前を設定します。 */
      type,                        /* パラメタのTypeCodeを設定します。 */
      &param,                      /* パラメタ領域のポインタを設定します */
      sizeof( CORBA_long ),        /* パラメタのサイズを設定します */
      CORBA_ARG_IN,                /* CORBA_ARG_INを設定します */
      &env );

クライアントアプリケーションで獲得した領域は、使用しなくなった時点で解放します。

outパラメタ

サーバアプリケーションの処理結果をoutパラメタで受け取る場合、クライアントアプリケーションで領域を獲得する必要はありません。CORBA_NVList_add_item()は、以下のように指定します。

CORBA_NVList_add_item(
      arg_list, 
      name,                        /* IDLで指定したパラメタの名前を設定します。 */
      type,                        /* パラメタのTypeCodeを設定します。 */
      NULL,                        /* NULLを設定します */
      0,                           /* 0を設定します */
      CORBA_ARG_OUT,               /* CORBA_ARG_OUTを設定します */
      &env );

サーバアプリケーションから渡されたデータの領域は、CORBA_NVList_free()でNVListクラスの領域を廃棄する際に自動的に解放されます。このため、NVListクラスの領域を解放した後、サーバアプリケーションから渡されたoutパラメタ領域を参照できません。NVListオブジェクトの解放については、“8.2.7 リクエストの削除”を参照してください。

inoutパラメタ

サーバアプリケーションにinoutパラメタを渡す場合は、クライアントアプリケーションでパラメタ領域を獲得し、そのポインタをCORBA_NVList_add_item()の第4パラメタに指定します。

CORBA_NVList_add_item(
      arg_list, 
      name,                        /* IDLで指定したパラメタの名前を設定します。 */
      type,                        /* パラメタのTypeCodeを設定します。 */
      &param,                      /* パラメタ領域のポインタを設定します */
      sizeof( CORBA_long ),        /* パラメタのサイズを設定します */
      CORBA_ARG_INOUT,             /* CORBA_ARG_INOUTを設定します */
      &env );

クライアントアプリケーションで獲得したパラメタ領域は、リクエスト発行後、使用しなくなった時点で解放してください。
サーバアプリケーションから渡されたデータ領域は、CORBA_NVList_free()でNVListクラスの領域を廃棄する際に自動的に解放されます。このため、NVListクラスの領域を解放した後、サーバアプリケーションから渡されたinoutパラメタ領域を参照できません。NVListオブジェクトの解放については、“8.2.7 リクエストの削除”を参照してください。

復帰パラメタ

サーバアプリケーションの処理結果を復帰パラメタで受け取る場合、クライアントアプリケーションで領域を獲得する必要はありません。
サーバアプリケーションから渡されたデータ領域は、CORBA_Request_delete()でリクエストオブジェクトを削除する際に、自動的に解放されます。