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で指定された名前で登録します。

　ロードバランスオブジェクトグループの生成に成功した場合、復帰値として生成したロードバランスオブジェクトグループのオブジェクトリファレンスが返却されます。

　loadbalancetypeには、roundrobinを指定します。

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

復帰値

　正常終了した場合は、envのexceptionメンバにNULLオブジェクトリファレンスが設定されます。
　異常終了した場合は、envのexceptionメンバにUserExceptionオブジェクトのオブジェクトリファレンスが設定されます。UserException_idに詳細情報が設定されます。_idの値と意味は次のとおりです。

　ISOD::LBO::NotFound

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

　ISOD::LBO::CannotProceed

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

　ISOD::LBO::InvalidName

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

　ISOD::LBO::AlreadyExist

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

　ISOD::LBO::InvalidType

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

　ISOD::LBO::BadObject

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

　ISOD::LBO::OperationBusy

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