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

4.11.4.3 CORBA-CONTAINER-LOOKUP-NAME

名前

　CORBA-CONTAINER-LOOKUP-NAME

形式

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 LONG IN CORBA REPLACING CORBA-LONG BY LEVELS-TO-SEARCH.
    01 COPY DEFINITIONKIND IN CORBA REPLACING CORBA-DEFINITIONKIND BY LIMIT-TYPE.
    01 COPY BOOLEAN IN CORBA REPLACING CORBA-BOOLEAN BY EXCLUDE-INHERITED.
    01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT BY ENV.
    01 COPY CONTAINEDSEQ IN CORBA REPLACING CORBA-CONTAINEDSEQ USAGE IS CONTAINEDSEQ.

PROCEDURE DIVISION.
    CALL "CORBA-CONTAINER-LOOKUP-NAME" USING
         OBJ
         SEARCH-NAME
         LEVELS-TO-SEARCH
         LIMIT-TYPE
         EXCLUDE-INHERITED 
         ENV
         CONTAINEDSEQ.

機能説明

　OBJで指定されたオブジェクトに直接包含される、または継承によって包含されるオブジェクトの中から、指定された名前を持つオブジェクトを見つけだし、そのオブジェクトリファレンスとともに、さらにそのオブジェクトが包含/継承するオブジェクトのオブジェクトリファレンスをリスト形式で返します。
　本関数はオブジェクトリファレンスのリストを格納する領域を獲得するため、この領域が不要になった時点で、CORBA-FREE関数を使用して領域を解放する必要があります。

• search-nameに、検索のキーとする名前（IDENTIFIER）を指定します。
• levels-to-searchには、検索の対象とする階層の深さを指定します。-1が指定されたときには、すべての階層に渡って検索を行い、1が指定されたときには、指定されたオブジェクトの直下にあるオブジェクトだけを検索します。
• limit-typeで指定されたインタフェースタイプの包含オブジェクトが返却対象となります。
• exclude-inheritedでTRUEが指定された場合は、継承オブジェクトは返却対象としません。
• limit-typeがCORBA-DK-ALLで、かつexclude-inheritedがFALSEの場合は、該当オブジェクト、およびそのオブジェクトが包含/継承するすべてのオブジェクトリファレンスのリストを返します。
• 返却対象のオブジェクトが見つからない場合は、返却リストのSEQ-LENGTHに0が設定され、オブジェクトリファレンスは不定となります。

復帰値

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