5.19.4.3 CORBA-CONTAINER-LOOKUP

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

目次索引

第5章 OOCOBOLインタフェース

> 5.19 インタフェースリポジトリインタフェース

> 5.19.4 Container共通インタフェース

5.19.4.3 CORBA-CONTAINER-LOOKUP_NAME

名前

　CORBA-CONTAINER-LOOKUP_NAME

形式

REPOSITORY.
     CLASS      SEQUENCE-CORBA-CONTAINED
     CLASS      CORBA-SYSTEMEXCEPTION

METHOD-ID. LOOKUP_NAME.
DATA DIVISION.
LINKAGE SECTION.
01 0--RESULT TYPE CORBA-CONTAINEDSEQ.
01 SEARCH_NAME PIC X ANY LENGTH.
01 LEVELS_TO_SEARCH TYPE CORBA-LONG.
01 LIMIT_TYPE TYPE CORBA-DEFINITIONKIND.
01 EXCLUDE_INHERITED TYPE CORBA-BOOLEAN.
PROCEDURE DIVISION
  USING      SEARCH_NAME
             LEVELS_TO_SEARCH
             LIMIT_TYPE
             EXCLUDE_INHERITED
  RETURNING 0―RESULT
  RAISING   CORBA-SYSTEMEXCEPTION
  .
END METHOD LOOKUP_NAME.

機能説明

　インタフェースリポジトリオブジェクトに直接包含される、または、継承によって包含されるオブジェクトの中から、指定された名前を持つオブジェクトを見つけだし、そのオブジェクトリファレンスとともに、さらにそのオブジェクトが包含/継承するオブジェクトのオブジェクトリファレンスをリスト形式で返します。

SEARCH_NAMEに、検索のキーとする名前（PIC X）を指定します。
LEVELS_TO_SEARCHには、検索の対象とする階層の深さを指定します。-1が指定されたときには、すべての階層に渡って検索を行い、1が指定されたときには、指定されたオブジェクトの直下にあるオブジェクトのみを検索します。
limit_typeで指定されたインタフェースタイプの包含オブジェクトが返却対象となります。
exclude_inheritedでTRUEが指定された場合は、継承オブジェクトは返却対象としません。
LIMIT_TYPEがCORBA-DK_ALLで、かつEXCLUDE_INHERITEDがFALSEの場合は、該当オブジェクトおよびそのオブジェクトが包含/継承するすべてのオブジェクトリファレンスのリストを返します。
返却対象のオブジェクトが見つからない場合は、返却リストのlengthに0が設定され、オブジェクトリファレンスは不定となります。

復帰値

　正常終了した場合は、検索されたオブジェクトのオブジェクトリファレンスのリストが返されます。
　異常終了した場合は、NIL（空の）オブジェクトリファレンスのリストが返され、SystemExceptionが発生します。

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

目次索引