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で指定された名前で登録します。ロードバランスオブジェクトグループの生成に成功した場合、生成したロードバランスオブジェクトグループのオブジェクトリファレンスを返します。
　本関数はオブジェクトリファレンスを格納する領域を獲得するため、この領域が不要になった時点で、CORBA_Object_release()を使用して領域を解放する必要があります。

パラメタ

　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サービスから通知される例外情報/マイナーコード”を参照してください。