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

1.16.1.1 ISOD_LBO_create_LBG()

名前

　ISOD_LBO_create_LBG

形式

　#include <orb.h>
　#include <OM_LBO.h>
　ISOD_LBG  ISOD_LBO_create_LBG(
        ISOD_LBO  lbo,
        CosNaming_NamingContext  nc,
        CosNaming_Name  *n,
        ISOD_LBO_LoadBalanceType  loadbalancetype,
        CORBA_Object  defaultobjectref,
        CORBA_Environment  *env );

機能説明

　本関数は、ロードバランスオブジェクトグループを作成し、ネーミングサービスに登録します。ncで指定されたネーミングコンテキスト配下にnで指定された名前で登録します。ロードバランスオブジェクトグループの生成に成功した場合、復帰値として生成したロードバランスオブジェクトグループのオブジェクトリファレンスが返却されます。
　loadbalancetypeには、"ISOD_LBO_roundrobin"を指定します。defaultobjectrefには、ロードバランス機能が動作していない場合にネーミングサービスが返却するオブジェクトリファレンス（デフォルトオブジェクトリファレンス）を指定してください。指定しない場合、ロードバランス機能が動作していない場合には、ネーミングサービスからはオブジェクトリファレンスが返却されません。このオブジェクトリファレンスは、ISOD_LBG_bind()およびISOD_LBG_unbind()では登録および削除はできません。指定した場合は、ロードバランスオブジェクトグループ作成後にISOD_LBG_rebind_default()を使用して変更することができます。

復帰値

　正常終了した場合は、env構造体の_majorにCORBA_NO_EXCEPTIONが設定されます。
　異常終了した場合は、CORBA_USER_EXCEPTIONが設定され、env構造体の_idに詳細情報が設定されます。_idの値と意味は次のとおりです。

　IDL:ISOD/LBO/NotFound:1.0

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

　IDL:ISOD/LBO/CannotProceed:1.0

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

　IDL:ISOD/LBO/InvalidName:1.0

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

　IDL:ISOD/LBO/AlreadyExist:1.0

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

　IDL:ISOD/LBO/InvalidType:1.0

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

　IDL:ISOD/LBO/BadObject:1.0

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

　IDL:ISOD/LBO/OperationBusy:1.0

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