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

5.18.1.10 COSNAMING-NAMINGCONTEXT-LIST

名前

　COSNAMING-NAMINGCONTEXT-LIST

形式

REPOSITORY.
    CLASS      CORBA-SYSTEMEXCEPTION

METHOD-ID.     LIST.
DATA DIVISION.
LINKAGE SECTION.
01 HOW_MANY              TYPE CORBA-UNSIGNED-LONG.
01 BL                    TYPE COSNAMING-BINDINGLIST.
01 BI                    OBJECT REFERENCE COSNAMING-BINDINGITERATOR.
PROCEDURE DIVISION       USING     HOW_MANY
                                   BL
                                   BI
                         RAISING   CORBA-SYSTEMEXCEPTION

機能説明

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

復帰値

　正常終了した場合は、ありません。
　異常終了した場合は、CORBA-SYSTEMEXCEPTIONが発生します。

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