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で指定された名前で登録します。ロードバランスオブジェクトグループの生成に成功した場合、生成したロードバランスオブジェクトグループのオブジェクトリファレンスを返します。

パラメタ

　lbo

　ロードバランスオブジェクトのオブジェクトリファレンス。

　nc

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

　n

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

　loadbalancetype

　ISOD_LBO_roundrobinを指定します。

　defaultobjref

　ロードバランス機能が動作していない場合に、ネーミングサービスが返すオブジェクトリファレンス（デフォルトオブジェクトリファレンス）。
　nullを指定した場合、かつロードバランス機能が動作していない場合は、ネーミングサービスからはオブジェクトリファレンスが返されません。
　このオブジェクトリファレンスは、ISOD_LBG_bind()およびISOD_LBG_unbind()では、登録および削除できません。
　デフォルトオブジェクトリファレンスは、ロードバランスオブジェクトグループ作成後に、ISOD_LBG_rebind_default()を使用して変更することができます。

　env

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

復帰値

　正常終了した場合は、生成したロードバランスオブジェクトグループのオブジェクトリファレンスが返され、env構造体の_majorにCORBA_NO_EXCEPTIONが設定されます。
　異常終了した場合は、env構造体の_majorにCORBA_SYSTEM_EXCEPTIONまたはCORBA_USER_EXCEPTIONが設定され、env構造体の_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

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

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