名前
CORBA::ORB::set_unbinded_object_rejecting -バインド関係未登録オブジェクトに対して例外を通知するインタフェースの登録
形式
void CORBA::ORB::set_unbinded_object_rejecting( CORBA::Char *IntfId, CORBA::Environment &env );
機能説明
インタフェースリポジトリID(IntfId)を登録します。登録されたインタフェースを持つオブジェクトのリクエストを受信した際に、オブジェクトのバインド関係がCORBAサービスに登録されていないとクライアントにシステム例外(INV_OBJREF)を通知します。
以下のいずれの場合に、バインド関係が登録されていない状態となります。
CORBA::ORB::bind_object()が未発行でバインド関係が登録されていない場合。
CORBA::ORB::unbind_object()が発行済みでバインド関係が解除されている場合。
セションタイムが検出されバインド関係が削除されている場合。
本関数はサーバプロセス毎に発行してください。また、複数のインタフェースを登録する場合は、本関数を複数回発行してください。
パラメタ
バインド関係が登録されていない場合に例外を通知するインタフェースリポジトリID。
例外情報が格納される構造体。
復帰値
正常復帰した場合の復帰値はありません。
異常終了した場合は、envのexceptionメンバにSystemExceptionオブジェクトのオブジェクトリファレンスが設定されます。設定される例外情報の意味は以下のとおりです。マイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。
活性化関数(CORBA::BOA::impl_is_readyまたはCORBA::BOA::obj_is_ready)発行後に、本関数が発行されました。
引数のインタフェースリポジトリID(IntfId)にNULLが指定されました。
クライアント用ライブラリ(ODWINCPP.LIB)が使用されています。
登録できる上限を超えました。
注意事項
活性化関数(CORBA::BOA::impl_is_readyまたはCORBA::BOA::obj_is_ready)を発行するよりも前に、本関数を発行する必要があります。
登録可能なインタフェースの数はプロセスで使用可能なメモリの量に依存します。
POA(Portable Object Adapter)を使用する場合は、本関数を発行してはいけません。
クライアント用ライブラリ(ODWINCPP.LIB)では使用できません。