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

4.11.4.1 CORBA-CONTAINER-LOOKUP

名前

　CORBA-CONTAINER-LOOKUP

形式

DATA DIVISION.
  WORKING-STORAGE SECTION.
    COPY CONST IN CORBA.
    01 COPY OBJECT IN CORBA REPLACING CORBA-OBJECT BY OBJ.
    01 SEARCH-NAME USAGE IS POINTER.
    01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT BY ENV.
    01 COPY CONTAINED IN CORBA REPLACING CORBA-CONTAINED BY C-CONTAINED.

PROCEDURE DIVISION.
    CALL "CORBA-CONTAINER-LOOKUP" USING
         OBJ
         SEARCH-NAME
         ENV
         C-CONTAINED.

機能説明

　OBJで指定されたインタフェースリポジトリオブジェクトが包含するインタフェースオブジェクトの中から、指定された名前を持つオブジェクトを見つけだし、そのオブジェクトリファレンスを返します。SEARCH-NAMEには、検索する名前（SCOPEDNAME)を指定します。返却対象のオブジェクトが見つからない場合は、NIL(空の)オブジェクトリファレンスを返して正常終了します。
　本関数はオブジェクトリファレンスを格納する領域を獲得するため、この領域が不要になった時点で、CORBA-OBJECT-RELEASE関数を使用して領域を解放する必要があります。

復帰値

　正常終了した場合、指定された名前を持つオブジェクトのオブジェクトリファレンスが返されます。
　異常終了した場合、NIL（空の）オブジェクトリファレンスが返されます。また、ENV構造体のMAJORにはCORBA-SYSTEM-EXCEPTIONが返され、IDとMINORに詳細情報が設定されます。IDとMINORの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。