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()の呼び出し時に使用します。

復帰値

　正常終了した場合は、envのexceptionメンバにNULLオブジェクトリファレンスが設定されます。
　異常終了した場合は、envのexceptionメンバにUserExceptionオブジェクトのオブジェクトリファレンスが設定されます。