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

2.15.8 CORBA::ORB::net_disconnect()

名前

  CORBA::ORB::net_disconnect - 通信資源の解放

形式

  void
  CORBA::ORB::net_disconnect(
        CORBA::Object_ptr         obj,
        CORBA::Environment&       env )

機能説明

  本関数は、objで指定されたオブジェクトが使用している通信資源を解放します。

パラメタ

  obj

  切断対象のオブジェクトリファレンス。

  env

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

復帰値

  正常終了した場合は、CORBA_NO_EXCEPTIONが返されます。
  異常終了した場合は、以下のCORBA_SYSTEM_EXCEPTIONが返されます。

  CORBA_INV_OBJREF

  不当なオブジェクトを指定しました。
  コネクションがすでに切断済です。

  CORBA_COMM_FAILURE

  通信異常が発生しました。

注意事項

• 本関数を発行した場合、クライアントアプリケーションの状態により以下のエラーが通知される場合があります。

  • スレッドモードで動作するアプリケーションの場合で本関数を発行したスレッド以外でサーバとの通信を行っていた場合、サーバと通信を行っているスレッドにCORBA_COMM_FAILUREが通知されます。

  • 非同期リクエストを発行している場合、非同期依頼の結果が受け取れません。

  • 同一のobjに対し本関数を発行した場合、CORBA_INV_OBJREFが通知されます。

  • サーバマシンに対するコネクション情報が存在しない場合は、CORBA_INV_OBJREFまたはCORBA_COMM_FAILUREが通知されます。

• 本関数を発行したクライアントプロセスで、パラメタに指定した解放対象のobjが存在するサーバマシンを共用するその他のオブジェクトの持つインスタンス情報も併せて解放されます。