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

3.16.1.10 org.omg.CosNaming.NamingContext.list()

名前

　org.omg.CosNaming.NamingContext.list()

形式

public void  list( int how_many,
      org.omg.CosNaming.BindingListHolder bl,
      org.omg.CosNaming.BindingIteratorHolder bi );

機能説明

　ネーミングコンテキスト中のバインディングのリストを、最大でhow_manyで指定された個数分返します。how_manyで指定された値が、nsconfigファイルのbl_how_manyパラメタで設定されている最大バインディング数より大きい場合、ネーミングサービスは最大bl_how_manyパラメタで指定された個数分のバインディングを返します。how_manyに0が設定された場合、クライアントはバインディングにアクセスするためのbiと、長さ0のシーケンスのblを返します。
　リストはblで指定されたorg.omg.CosNaming.BindingListHolderに設定されます。ネーミングコンテキスト内のバインディングの数がhow_manyで指定された数よりも多い場合、ネーミングコンテキスト内での現在の位置を示すオブジェクトが生成され、このオブジェクトリファレンスがbiに返されます。このオブジェクトをバインディングアイテレータといいます。biに返されたオブジェクトリファレンスは、org.omg.CosNaming.BindingIterator.next_oneおよびorg.omg.CosNaming.BindingIterator.next_nの呼び出し時に使用します。

パラメタ

　how_many

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

　bl

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

　bi

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

復帰値

　正常終了した場合は、blにリストオブジェクトリファレンスが設定されます。
　異常終了した場合は、以下の例外が発生します。
　　org.omg.CORBA.SystemException

　システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。