1.10.3 Contained共通インタフェース

ここで説明する関数は、インタフェースリポジトリオブジェクトが他のインタフェースリポジトリオブジェクトに包含される関係を持ち得る各インタフェースリポジトリオブジェクト（このインタフェースリポジトリオブジェクトをContainedと呼ぶ）に継承されて、その継承先のインタフェースリポジトリオブジェクトの関数として使用できます。

名前

CORBA_Contained__get_id

形式

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

機能説明

objに指定したインタフェースリポジトリオブジェクトのリポジトリIDを返します。
本関数はリポジトリIDを格納する領域を獲得するため、この領域が不要になった時点で、CORBA_free()を使用して領域を解放する必要があります。

パラメタ

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

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

復帰値

正常終了した場合は、リポジトリIDが返されます。
異常終了した場合は、env構造体の_majorにはCORBA_SYSTEM_EXCEPTIONが返され、_idと_minorに詳細情報が設定されます。

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

名前

CORBA_Contained__get_name

形式

  #include <orb.h>
  #include <InterfaceRep.h>
  CORBA_Identifier  CORBA_Contained__get_name(
        CORBA_Object  obj, 
        CORBA_Environment  *env );

機能説明

objで指定したインタフェースリポジトリオブジェクトの名前を返します。
本関数はオブジェクトの名前を格納する領域を獲得するため、この領域が不要になった時点で、CORBA_free()を使用して領域を解放する必要があります。

パラメタ

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

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

復帰値

正常終了した場合は、名前（CORBA_Identifier:String型）が返されます。
異常終了した場合は、env構造体の_majorにはCORBA_SYSTEM_EXCEPTIONが返され、_idと_minorに詳細情報が設定されます。

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

名前

CORBA_Contained__get_defined_in

形式

  #include <orb.h>
  #include <InterfaceRep.h>
  CORBA_Container  CORBA_Contained__get_defined_in(
        CORBA_Object  obj,
        CORBA_Environment  *env );

機能説明

objが指すインタフェースリポジトリオブジェクトを包含しているオブジェクト（Container)のオブジェクトリファレンスを返します。
本関数はオブジェクトリファレンスを格納する領域を獲得するため、この領域が不要になった時点で、CORBA_Object_release()を使用して領域を解放する必要があります。

パラメタ

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

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

復帰値

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

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

名前

CORBA_Contained_describe

形式

  #include <orb.h>
  #include <InterfaceRep.h>
  CORBA_Contained_Description  *CORBA_Contained_describe(
        CORBA_Object  obj,
        CORBA_Environment  *env );

機能説明

objに指定したインタフェースリポジトリオブジェクトの情報を表すCORBA_Contained_Description構造体を返します。返される情報はそれぞれのインタフェースリポジトリオブジェクトにより異なり、各インタフェースリポジトリオブジェクト固有の情報はCORBA_Contained_Description構造体のvalueメンバに保持されます。valueはCORBA_any型の構造体であり、その_valueメンバにはインタフェースリポジトリオブジェクトの種別によって、それぞれ次の構造体のアドレスが設定されます。各構造体の詳細は“1.10.1 型の定義”を参照してください。

CORBA_ModuleDefオブジェクト: ModuleDescription構造体

CORBA_ConstantDefオブジェクト: ConstantDescription構造体

CORBA_StructDefオブジェクト: TypeDescription構造体

CORBA_UnionDefオブジェクト: TypeDescription構造体

CORBA_EnumDefオブジェクト: TypeDescription構造体

CORBA_AliasDefオブジェクト: TypeDescription構造体

CORBA_ExceptionDefオブジェクト: ExceptionDescription構造体

CORBA_AttributeDefオブジェクト: AttributeDescription構造体

CORBA_OperationDefオブジェクト: OperationDescription構造体

CORBA_InterfaceDefオブジェクト: InterfaceDescription構造体

本関数はCORBA_Contained_Description構造体を格納する領域を獲得するため、この領域が不要になった時点で、CORBA_free()を使用して領域を解放する必要があります。

パラメタ

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

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

復帰値

正常終了した場合は、CORBA_Description構造体のアドレスが返されます。
異常終了した場合は、env構造体の_majorにはCORBA_SYSTEM_EXCEPTIONが返され、_idと_minorに詳細情報が設定されます。

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

(1) CORBA_Contained__get_def_kind()

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

1.10.3 Contained共通インタフェース

1.10.3.1 CORBA_Contained__get_id()

1.10.3.2 CORBA_Contained__get_name()

1.10.3.3 CORBA_Contained__get_defined_in()

1.10.3.4 CORBA_Contained_describe()

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