名前
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()を使用して領域を解放する必要があります。
パラメタ
バインディングの設定領域。
例外情報が格納される構造体。
復帰値
正常終了した場合で、有効なバインディングが1個以上返された場合にはCORBA::TRUEが、まだリストされていないバインディングが存在しない場合にはCORBA::FALSEが返されます。
異常終了した場合は、envのexceptionメンバにSystemExceptionが設定されます。設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。
名前
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()を使用して領域を解放する必要があります。
パラメタ
獲得したいバインディングリストの個数。
バインディングリストの設定領域。
例外情報が格納される構造体。
復帰値
正常終了した場合で、有効なバインディングが返された場合にはCORBA::TRUEが、まだリストされていないバインディングが存在しない場合にはCORBA::FALSEが返されます。
異常終了した場合は、envのexceptionメンバにSystemExceptionが設定されます。設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。
名前
CosNaming::BindingIterator::destroy
形式
#include <orb_cplus.h>
#include <CosNaming_cplus.h>
void CosNaming::BindingIterator::destroy(
CORBA::Environment& env );機能説明
バインディングアイテレータを破棄します。
パラメタ
例外情報が格納される構造体。
復帰値
正常終了した場合は、envのexceptionメンバにNULLオブジェクトリファレンスが設定されます。
異常終了した場合は、envのexceptionメンバにSystemExceptionが設定されます。設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。