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

1.10.3 Contained共通インタフェース

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

1.10.3.1 CORBA_Contained__get_id()

名前

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

1.10.3.2 CORBA_Contained__get_name()

名前

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

1.10.3.3 CORBA_Contained__get_defined_in()

名前

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

1.10.3.4 CORBA_Contained_describe()

名前

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.10.3.5 継承されて使用できる関数

(1) CORBA_Contained__get_def_kind()

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

関数の仕様については、“1.10.2 IRObject共通インタフェース”を参照してください。