1.10.6 Repositoryインタフェース

名前

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サービスから通知される例外情報/マイナーコード”を参照してください。

(1) CORBA_Repository__get_def_kind
(2) CORBA_Repository_lookup
(3) CORBA_Repository_contents
(4) CORBA_Repository_lookup_name
(5) CORBA_Repository_describe_contents

  (1)については、“IRObject共通インタフェース”を継承します。
  “CORBA_IRObject”の部分を“CORBA_Repository”に置き換えて使用することができます。
  関数の仕様については、“1.10.2 IRObject共通インタフェース”を参照してください。

  (2)～(5)については、“Container共通インタフェース”を継承します。
  “CORBA_Container”の部分を“CORBA_Repository”に置き換えて使用することができます。
  関数の仕様については、“1.10.4 Container共通インタフェース”を参照してください。

1.10.6 Repositoryインタフェース

1.10.6.1 CORBA_Repository_lookup_id()

1.10.6.2 継承されて使用できる関数