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

4.2.8 CORBA-ORB-CREATE-LIST

名前

　CORBA-ORB-CREATE-LIST

形式

 ENVIRONMENT DIVISION.
   CONFIGURATION SECTION.
   SPECIAL-NAMES.
     SYMBOLIC CONSTANT
     COPY SYMBOL-CONST IN CORBA.
     .
 DATA DIVISION.
  WORKING-STORAGE SECTION.
    COPY CONST IN CORBA.
    01 COPY ORB IN CORBA REPLACING CORBA-ORB BY ORB.
    01 COPY LONG IN CORBA REPLACING CORBA-LONG BY C-COUNT.
    01 NEW-LIST USAGE POINTER.
    01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT BY ENV.
    01 COPY STATUS IN CORBA REPLACING CORBA-STATUS BY ORB-STATUS.

 PROCEDURE DIVISION.
    CALL "CORBA-ORB-CREATE-LIST" USING
        ORB
        C-COUNT
        NEW-LIST
        ENV
        ORB-STATUS.

機能説明

　C-COUNTで指定した項目数分のパラメタを格納できるリストオブジェクト（CORBA-NVLIST）を生成します。
　ここで生成したリストオブジェクトにパラメタを追加するには、CORBA-NVLIST-ADD-ITEM関数(NVListインタフェース）を用います。
　ORBには、CORBA-ORB-INIT関数で返されるORBのオブジェクトリファレンスを指定します。

復帰値

　正常終了した場合は、CORBA-OKが返され、NEW-LISTにリストオブジェクトが設定されます。
　異常終了した場合は、CORBA-FAILEDが返されます。
　ORB, C-COUNTにNULLが指定された場合、ENV構造体のMAJORにはCORBA-USER-EXCEPTIONが設定されます。