1.6.3 CORBA_Request

名前

CORBA_Request_send

形式

  #include <orb.h>
  CORBA_ORBStatus  CORBA_Request_send(
        CORBA_Request  req,
        CORBA_Flags  invoke_flags,
        CORBA_Environment  *env );
  typedef  CORBA_Object  CORBA_Request;

機能説明

reqで指定したリクエストオブジェクトの生成時に指定したサーバアプリケーションの関数を呼び出します。結果はCORBA_Object_create_request()で指定されたresult引数に入れられます。CORBA_Request_invoke()と異なり、サーバアプリケーションの処理が終わるのを待たずに呼び出し元に制御を返します。

オペレーションの結果は、CORBA_Request_get_response()によって通知されます。オペレーションがonewayと定義されているか、またはinvoke_flagsにCORBA_INV_NO_RESPONSEが指定されているときは、CORBA_Request_get_response()を呼ぶ必要はありません。

パラメタ

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

invoke_flags

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

CORBA_INV_NO_RESPONSE: 呼び出し元は返答を待ちません。また、いずれの出力パラメタ（inoutおよびoutの場合）も更新されません。このオプションは、操作がonewayと定義されていないときでも指定することができます。

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

復帰値

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

注意事項

invoke_flagsにCORBA_INV_NO_RESPONSEを指定する場合、呼び出すサーバのメソッドにはOUTパラメタ・INOUTパラメタが存在してはいけません。また、メソッドの復帰値の型はvoidである必要があります。

1.6.3 CORBA_Request_send()