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

1.10.4.2 CORBA_Container_contents()

名前

　CORBA_Container_contents

形式

　#include <orb.h>
　#include <InterfaceRep.h>
　CORBA_ContainedSeq  *CORBA_Container_contents(
        CORBA_Object  obj,
        CORBA_DefinitionKind  limit_type,
        CORBA_boolean  exclude_inherited,
        CORBA_Environment  *env );

機能説明

　objに指定されたインタフェースリポジトリオブジェクトに直接包含される、または継承によって包含されるインタフェースリポジトリオブジェクトのオブジェクトリファレンスをリスト形式で返します。
　返却対象のオブジェクトが見つからない場合は、返却リストの_lengthに0が設定され、オブジェクトリファレンスは不定となります。
　本関数はオブジェクトリファレンスのリストを格納する領域を獲得するため、この領域が不要になった時点で、CORBA_free()を使用して領域を解放する必要があります。

パラメタ

　obj

　インタフェースリポジトリオブジェクト。

　limit_type

　検索するインタフェースタイプの包含オブジェクト。
　本パラメタにCORBA_dk_allを指定し、exclude_inheritedにFALSEを指定すると、包含/継承するすべてのオブジェクトリファレンスを対象とします。

　exclude_inherited

　TRUE：
　　継承オブジェクトを検索の対象としません。
　FALSE：
　　継承オブジェクトを検索の対象とします。

　env

　例外情報が格納される構造体。

復帰値

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

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