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

2.14.4.4 CORBA::Container::describe_contents()

名前

　CORBA::Container::describe_contents

形式

　#include <orb_cplus.h>
　CORBA::DescriptionSeq  *CORBA::Container::describe _contents(
        CORBA::DefinitionKind  limit_type,
        CORBA::Boolean         exclude_inherited,
        CORBA::long            max_returned _objs,
        CORBA::Environment&    env );

機能説明

　インタフェースリポジトリオブジェクトに直接包含される、または継承によって包含されるオブジェクトの定義情報を、Description構造体のリスト形式（“型の定義”を参照してください）で返します。

• limit_typeで指定されたインタフェースタイプの包含オブジェクトが返却対象となります。
• exclude_inheritedでTRUEが指定された場合は、継承オブジェクトは返却対象としません。
• max_returned_objsで指定された数分の定義情報が返却されます。
• limit_typeがdk_allで、かつexclude_inheritedがFALSEの場合は、包含/継承されるすべてのオブジェクト定義情報リストを返します。ただし、この場合もmax_returned_objsで指定された数分だけが返却対象となります。（登録されている数分得る場合は、max_returned_objsに-1を指定します）
• 返却対象のオブジェクトが見つからない場合は、返却リストのlengthに0が設定され、オブジェクトリファレンスは不定となります。

復帰値

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