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

2.14.4.3 CORBA::Container::lookup_name()

名前

　CORBA::Container::lookup_name

形式

　#include <orb_cplus.h>
　CORBA::ContainedSeq  *CORBA::Container::lookup _name(
        CORBA::Identifier      search_name,
        CORBA::long            levels_to_search,
        CORBA::DefinitionKind  limit_type,
        CORBA::Boolean         exclude_inherited,
        CORBA::Environment&    env );

機能説明

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

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

復帰値

　正常終了した場合は、検索されたオブジェクトのオブジェクトリファレンスのリストが返されます。
　異常終了した場合は、NIL（空の）オブジェクトリファレンスのリストが返され、envのexceptionメンバにSystemExceptionオブジェクトのオブジェクトリファレンスが設定されます。設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。