名前
COSNAMING-BINDINGITERATOR-NEXT-ONE
形式
ENVIRONMENT DIVISION.
CONFIGURATION SECTION.
SPECIAL-NAMES.
SYMBOLIC CONSTANT
COPY SYMBOL-CONST IN CORBA.
.
DATA DIVISION.
COPY CONST IN CORBA.
01 B USAGE POINTER.
01 BI USAGE POINTER.
01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT BY ENV.
01 COPY LONG IN CORBA REPLACING CORBA-LONG BY RET.
PROCEDURE DIVISION.
CALL "COSNAMING-BINDINGITERATOR-NEXT-ONE" USING
BI
B
ENV
RET.機能説明
BIで指定されたバインディングアイテレータにより示されるネーミングコンテキスト内の現在の位置から、次のバインディングを1つ取り出してBに格納します。
本関数はバインディングアイテレータおよびバインディングリストを格納する領域を獲得するため、これらの領域が不要になった時点で、COSNAMING-NAMINGCONTEXT-DESTROY関数およびCORBA-FREE関数を使用して領域を解放する必要があります。
復帰値
正常終了した場合で、有効なバインディングが1個以上返された場合にはCORBA-TRUE-VALUEが、まだリストされていないバインディングが存在しない場合にはCORBA-FALSE-VALUEが返され、ENV構造体のMAJORにCORBA-NO-EXCEPTIONが設定されます。
異常終了した場合は、ENV構造体のMAJORにCORBA-SYSTEM-EXCEPTIONが設定され、IDとMINORに詳細情報が設定されます。IDとMINORの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。
名前
COSNAMING-BINDINGITERATOR-NEXT-N
形式
ENVIRONMENT DIVISION.
CONFIGURATION SECTION.
SPECIAL-NAMES.
SYMBOLIC CONSTANT
COPY SYMBOL-CONST IN CORBA.
.
DATA DIVISION.
COPY CONST IN CORBA.
01 COPY COSNAMING-BINDINGITERATOR IN CORBA REPLACING COSNAMING-
BINDINGITERATOR BY BI.
01 COPY LONG IN CORBA REPLACING CORBA-LONG BY HOW-MANY.
01 BL USAGE POINTER.
01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT BY ENV.
01 COPY LONG IN CORBA REPLACING CORBA-LONG BY RET.
PROCEDURE DIVISION.
CALL "COSNAMING-BINDINGITERATOR-NEXT-N" USING
BI
HOW-MANY
BL
ENV
RET.機能説明
BIで指定されたバインディングアイテレータにより示されるネーミングコンテキスト内の現在の位置から、次のバインディングを最大HOW-MANYで指定された個数分取り出してBLに格納します。HOW-MANYで指定された値が、nsconfigファイルのbl_how_manyパラメタで設定されている最大バインディング数より大きい場合、ネーミングサービスは最大bl_how_manyパラメタで指定された個数分のバインディングを返します。HOW-MANYに0が設定された場合、BAD_PARAMシステム例外が発生します。
本関数はバインディングアイテレータおよびバインディングリストを格納する領域を獲得するため、これらの領域が不要になった時点で、COSNAMING-NAMINGCONTEXT-DESTROY関数およびCORBA-FREE関数を使用して領域を解放する必要があります。
復帰値
正常終了した場合で、有効なバインディングが返された場合にはCORBA-TRUE-VALUEが、まだリストされていないバインディングが存在しない場合にはCORBA-FALSE-VALUEが返され、ENV構造体のMAJORにCORBA-NO-EXCEPTIONが設定されます。
異常終了した場合は、ENV構造体のMAJORにCORBA-SYSTEM-EXCEPTIONが設定され、IDとMINORに詳細情報が設定されます。IDとMINORの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。
名前
COSNAMING-BINDINGITERATOR-DESTROY
形式
ENVIRONMENT DIVISION.
CONFIGURATION SECTION.
SPECIAL-NAMES.
SYMBOLIC CONSTANT
COPY SYMBOL-CONST IN CORBA.
.
DATA DIVISION.
COPY CONST IN CORBA.
01 COPY COSNAMING-BINDINGITERATOR IN CORBA REPLACING COSNAMING-BINDINGITERATOR BY BI.
01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT BY ENV.
PROCEDURE DIVISION.
CALL "COSNAMING-BINDINGITERATOR-DESTROY" USING
BI
ENV.機能説明
BIで指定されたバインディングアイテレータを破棄します。
復帰値
正常終了した場合は、ENV構造体のMAJORにCORBA-NO-EXCEPTIONが設定されます。
異常終了した場合は、ENV構造体のMAJORにCORBA-SYSTEM-EXCEPTIONが設定され、IDとMINORに詳細情報が設定されます。IDとMINORの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。