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

1.6.3 CORBA_Request_send()

名前

　CORBA_Request_send

形式

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

機能説明

　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である必要があります。