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

1.10.4.4 CORBA_Container_describe_contents()

名前

　CORBA_Container_describe_contents

形式

　#include <orb.h>
　#include <InterfaceRep.h>
　CORBA_Container_DescriptionSeq  *CORBA_Container_describe_contents(
        CORBA_Object  obj,
        CORBA_DefinitionKind  limit_type,
        CORBA_boolean  exclude_inherited,
        CORBA_long  max_returned_objs, 
        CORBA_Environment  *env );

機能説明

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

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

復帰値

　正常終了した場合は、オブジェクトの定義情報リストが返されます。
　異常終了した場合は、NIL（空の)定義情報リストが返されます。また、env構造体の_majorにはCORBA_SYSTEM_EXCEPTIONが返され、_idと_minorに詳細情報が設定されます。

　_idと_minorの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。