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

1.10.6.1 CORBA_Repository_lookup_id()

名前

　CORBA_Repository_lookup_id

形式

　#include <orb.h>
　#include <InterfaceRep.h>
　CORBA_Contained  CORBA_Repository_lookup_id(
        CORBA_Object  obj,
        CORBA_RepositoryId  search_id,
        CORBA_Environment  *env );

機能説明

　search_idで指定したリポジトリIDを持つオブジェクトを検索し、そのオブジェクトリファレンスを返します。
　返却対象のオブジェクトが見つからない場合は、NIL(空の)オブジェクトリファレンスを返して正常終了します。
　本関数はオブジェクトリファレンスを格納する領域を獲得するため、この領域が不要になった時点で、CORBA_Object_release()を使用して領域を解放する必要があります。

パラメタ

　obj

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

　search_id

　検索するリポジトリIDを持つオブジェクト。

　env

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

復帰値

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

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