Interstage Application Server リファレンスマニュアル（API編）

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システム例外が発生します。

パラメタ

　how_many

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

　bl

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

　env

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

復帰値

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