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

2.13.2.10 CosNaming::NamingContext::list()

名前

　CosNaming::NamingContext::list

形式

　#include <orb_cplus.h>
　#include <CosNaming_cplus.h>
　void CosNaming::NamingContext::list(
        CORBA_ULong how_many,
        CosNaming::BindingList *&bl,
        CosNaming::BindingIterator_ptr bi,
        CORBA::Environment& env );

機能説明

　ネーミングコンテキスト中のバインディングのリストを、最大でhow_manyで指定された個数分返します。how_manyで指定された値が、nsconfigファイルのbl_how_manyパラメタで設定されている最大バインディング数より大きい場合、ネーミングサービスは最大bl_how_manyパラメタで指定された個数分のバインディングを返します。how_manyに0が設定された場合、クライアントはバインディングにアクセスするためのbiと、長さ0のシーケンスのblを返します。
　リストはblで指定されたCosNaming::BindingListに設定されます。CosNaming::BindingListはCosNaming cplus.hで宣言されています。

　ネーミングコンテキスト内のバインディングの数がhow_manyで指定された数よりも多い場合、ネーミングコンテキスト内での現在の位置を示すオブジェクトが生成され、このオブジェクトリファレンスがbiに返されます。このオブジェクトをバインディングアイテレータといいます。biに返されたオブジェクトリファレンスは、CosNaming::BindingIterator::next_one()、およびCosNaming::BindingIterator::next_n()の呼び出し時に使用します。

パラメタ

　how_many

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

　bl

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

　bi

　バインディングアイテレータの設定領域。

　env

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

復帰値

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