1.16.2 ロードバランスオブジェクトグループインタフェース

名前

ISOD_LBG_bind

形式

#include <orb.h>
#include <OM_LBO.h>
void  ISOD_LBG_bind(
      ISOD_LBG  lbg,
      CORBA_Object  objectref,
      CORBA_Environment  *env );

機能説明

本関数は、objectrefで指定されたロードバランス対象のオブジェクトを、lbgで指定されたロードバランスオブジェクトグループに登録します。

パラメタ

lbg: ロードバランスオブジェクトグループのオブジェクトリファレンス。

objectref: ロードバランスオブジェクトグループに登録するオブジェクトリファレンス。

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

復帰値

正常終了した場合は、env構造体の_majorにCORBA_NO_EXCEPTIONが設定されます。
異常終了した場合は、env構造体の_majorにCORBA_SYSTEM_EXCEPTIONまたはCORBA_USER_EXCEPTIONが設定され、env構造体の_idに詳細情報が設定されます。

ユーザ例外の場合は、以下の詳細情報が設定されます。

IDL:ISOD/LBG/AlreadyBound:1.0: すでに登録済のオブジェクトと同一の情報を持つオブジェクトが指定されました。

IDL:ISOD/LBG/CannotProceed2:1.0: ロードバランス機能のDBの処理で異常が発生しました。または、objectrefの指定に誤りがあります。

IDL:ISOD/LBG/BadObject:1.0: objectrefで指定されたオブジェクトが不当です。

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

1.16.2.2 ISOD_LBG_unbind()

名前

ISOD_LBG_unbind

形式

#include <orb.h>
#include <OM_LBO.h>
void  ISOD_LBG_unbind(
      ISOD_LBG  lbg,
      CORBA_Object  objectref,
      CORBA_Environment  *env );

機能説明

本関数は、objectrefで指定されたロードバランス対象のオブジェクトを、lbgで指定されたロードバランスオブジェクトグループから削除します。

パラメタ

lbg: ロードバランスオブジェクトグループのオブジェクトリファレンス。

objectref: ロードバランスオブジェクトグループから削除するオブジェクトリファレンス。

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

復帰値

ユーザ例外の場合は、以下の詳細情報が設定されます。

IDL:ISOD/LBG/NotFound:1.0: objectrefで指定されたオブジェクトが見つかりません。

IDL:ISOD/LBG/CannotProceed2:1.0: ロードバランス機能のDBの処理で異常が発生しました。または、objectrefの指定に誤りがあります。

IDL:ISOD/LBG/BadObject:1.0: objectrefで指定されたオブジェクトが不当です。

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

1.16.2.3 ISOD_LBG_rebind_default()

名前

ISOD_LBG_rebind_default

形式

#include <orb.h>
#include <OM_LBO.h>
CORBA_Object ISOD_LBG_rebind_default(
      ISOD_LBG  lbg,
      CORBA_Object  objectref,
      CORBA_Environment  *env );

機能説明

本関数は、lbgで指定されたロードバランスオブジェクトグループのデフォルトオブジェクトを、objectrefで指定されたオブジェクトに変更します。
本関数はオブジェクトリファレンスを格納する領域を獲得するため、この領域が不要になった時点で、CORBA_Object_release()を使用して領域を解放する必要があります。

パラメタ

lbg: ロードバランスオブジェクトグループのオブジェクトリファレンス。

objectref: デフォルトオブジェクトとして登録するオブジェクトリファレンス。

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

復帰値

正常終了した場合は、変更前のデフォルトオブジェクトのオブジェクトリファレンスが返され、env構造体の_majorにCORBA_NO_EXCEPTIONが設定されます。
異常終了した場合は、env構造体の_majorにCORBA_SYSTEM_EXCEPTIONまたはCORBA_USER_EXCEPTIONが設定され、env構造体の_idに詳細情報が設定されます。

ユーザ例外の場合は、以下の詳細情報が設定されます。

IDL:ISOD/LBG/CannotProceed:1.0: デフォルトオブジェクトが設定されていません。

IDL:ISOD/LBG/CannotProceed2:1.0: ロードバランス機能のDBの処理で異常が発生しました。または、objectrefの指定に誤りがあります。

IDL:ISOD/LBG/BadObject:1.0: objectrefで指定されたオブジェクトが不当です。

IDL:ISOD/LBG/OperationBusy:1.0: 同時処理可能な要求の上限に達しました。リトライしてください。

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

1.16.2.4 ISOD_LBG_list()

名前

ISOD_LBG_list

形式

#include <orb.h>
#include <OM_LBO.h>
void ISOD_LBG_list(
      ISOD_LBG  lbg,
      ISOD_LBG_ObjectList  **objectref,
      CORBA_Environment  *env );

機能説明

lbgで指定されるロードバランスオブジェクトグループに登録済のオブジェクトのオブジェクトリファレンスの一覧を返します。
本関数はオブジェクトのリストを格納する領域を獲得するため、この領域が不要になった時点で、CORBA_free()を使用して領域を解放する必要があります。

パラメタ

lbg: ロードバランスオブジェクトグループのオブジェクトリファレンス。

objectref: オブジェクトのリストの設定領域。

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

復帰値

ユーザ例外の場合は、以下の詳細情報が設定されます。

IDL:ISOD/LBG/CannotProceed2:1.0: ロードバランス機能のDBの処理で異常が発生しました。

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