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

2.20.1.1 ISOD::LBO::create_LBG()

名前

　ISOD::LBO::create_LBG

形式

　#include <orb_cplus.h>
　#include <OM_LBOcpp.h>
　ISOD::LBG_ptr  ISOD::LBO::create_LBG(
        CosNaming::NamingContext_ptr  nc,
        CosNaming::Name  &n,
        ISOD::LBO::LoadBalanceType  loadbalancetype,
        CORBA::Object_ptr  defaultobjectref,
        CORBA::Environment  &env);

機能説明

　本関数は、ロードバランスオブジェクトグループを作成し、ネーミングサービスに登録します。ncで指定されたネーミングコンテキスト配下にnで指定された名前で登録します。
　ロードバランスオブジェクトグループの生成に成功した場合、生成したロードバランスオブジェクトグループのオブジェクトリファレンスを返します。

パラメタ

　nc

　ネーミングコンテキストオブジェクト。

　n

　作成するロードバランスオブジェクトグループ名。

　loadbalancetype

　roundrobinを指定します。

　defaultobjref

　ロードバランス機能が動作していない場合に、ネーミングサービスが返すオブジェクトリファレンス（デフォルトオブジェクトリファレンス）。
　nullを指定した場合、かつロードバランス機能が動作していない場合は、ネーミングサービスからはオブジェクトリファレンスが返されません。
　このオブジェクトリファレンスは、ISOD::LBG::bind()およびISOD::LBG::unbind()では、登録および削除できません。
　指定した場合は、ロードバランスオブジェクトグループ作成後に、ISOD::LBG::rebind_default()オペレーションを使用して変更することができます。指定するオブジェクトリファレンスのインタフェースリポジトリIDは、OMG IDL形式("IDL:"で始まる形式)を使用してください。

　env

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

復帰値

　正常終了した場合は、生成したロードバランスオブジェクトグループのオブジェクトリファレンスが返され、envのexceptionメンバにNULLオブジェクトリファレンスが設定されます。
　異常終了した場合は、envのexceptionメンバにSystemExceptionオブジェクト、またはUserExceptionオブジェクトのオブジェクトリファレンスが設定されます。
　ユーザ例外の場合は、以下の例外が発生します。

　ISOD::LBO::NotFound

　nで指定されたネーミングコンテキストが見つかりません。

　ISOD::LBO::CannotProceed

　ncで指定されたネーミングコンテキストが存在しません。

　ISOD::LBO::InvalidName

　名前の指定に誤りがあります。

　ISOD::LBO::AlreadyExist

　指定された名前のバインディングがすでに存在します。

　ISOD::LBO::InvalidType

　ロードバランスタイプの指定に誤りがあります。

　ISOD::LBO::BadObject

　defaultobjectrefで指定されたオブジェクトが不当です。

　ISOD::LBO::OperationBusy

　同時処理可能な要求の上限に達しました。リトライしてください。

　システム例外の場合は、設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。