2.13.3 バインディングアイテレータインタフェース

名前

CosNaming::BindingIterator::next_one

形式

#include <orb_cplus.h>
#include <CosNaming_cplus.h>
CORBA::Boolean CosNaming::BindingIterator::next_one(
      CosNaming::Binding& *b,
      CORBA::Environment& env );

機能説明

バインディングアイテレータにより示されるネーミングコンテキスト内の現在の位置から、次のバインディングを1つ取り出してbに格納します。
本関数はバインディングアイテレータを格納する領域を獲得するため、これらの領域が不要になった時点で、CosNaming::BindingIterator::destroy()を使用して領域を解放する必要があります。

パラメタ

b: バインディングの設定領域。

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

復帰値

正常終了した場合で、有効なバインディングが1個以上返された場合にはCORBA::TRUEが、まだリストされていないバインディングが存在しない場合にはCORBA::FALSEが返されます。
異常終了した場合は、envのexceptionメンバにSystemExceptionが設定されます。設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

2.13.3.2 CosNaming::BindingIterator::next_n()

名前

CosNaming::BindingIterator::next_n

形式

#include <orb_cplus.h>
#include <CosNaming_cplus.h>
CORBA::Boolean CosNaming::BindingIterator::next_n(
      CORBA::ULong how_many,
      CosNaming::BindingList *&bl,
      CORBA::Environment& env );

機能説明

バインディングアイテレータにより示されるネーミングコンテキスト内の現在の位置から、次のバインディングを最大how_manyで指定された個数分取り出してblに格納します。how_manyで指定された値が、nsconfigファイルのbl_how_manyパラメタで設定されている最大バインディング数より大きい場合、ネーミングサービスは最大bl_how_manyパラメタで指定された個数分のバインディングを返します。how_manyに0が設定された場合、BAD_PARAMシステム例外が発生します。
本関数はバインディングアイテレータを格納する領域を獲得するため、これらの領域が不要になった時点で、CosNaming::BindingIterator::destroy()を使用して領域を解放する必要があります。

パラメタ

how_many: 獲得したいバインディングリストの個数。

bl: バインディングリストの設定領域。

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

復帰値

正常終了した場合で、有効なバインディングが返された場合にはCORBA::TRUEが、まだリストされていないバインディングが存在しない場合にはCORBA::FALSEが返されます。
異常終了した場合は、envのexceptionメンバにSystemExceptionが設定されます。設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

2.13.3.3 CosNaming::BindingIterator::destroy()

名前

CosNaming::BindingIterator::destroy

形式

#include <orb_cplus.h>
#include <CosNaming_cplus.h>
void CosNaming::BindingIterator::destroy(
       CORBA::Environment& env );

機能説明

バインディングアイテレータを破棄します。

パラメタ

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

復帰値

正常終了した場合は、envのexceptionメンバにNULLオブジェクトリファレンスが設定されます。
異常終了した場合は、envのexceptionメンバにSystemExceptionが設定されます。設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。