1.3.3 CORBA_BOA_get

名前

CORBA_BOA_get_id

形式

#include <orb.h>
CORBA_ReferenceData  *CORBA_BOA_get_id(
      CORBA_BOA  boa,
      CORBA_Object  obj,
      CORBA_Environment *env );
typedef CORBA_sequence_octet  CORBA_ReferenceData;
typedef struct {
      CORBA_unsigned_long  _maximum;
      CORBA_unsigned_long  _length;
      CORBA_octet  *_buffer;
} CORBA_sequence_octet;

機能説明

objで指定したオブジェクトリファレンスの識別情報を返します。この情報はCORBA_BOA_create()で指定した識別情報が返され、オブジェクトが破壊されるまで変化しません。識別情報は、CORBA_sequence_octet構造体の_bufferに設定されます。

本関数はオブジェクトリファレンスの識別情報を格納する領域を獲得するため、この領域が不要になった時点で、CORBA_free()を使用して領域を解放する必要があります。

パラメタ

boa: CORBA_ORB_BOA_init()で返されたオブジェクトリファレンスを指定します。

obj: ここで指定したオブジェクトリファレンスの識別情報を返します。

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

復帰値

正常終了した場合は、識別情報（オクテット型）が返され、env構造体の_majorにはCORBA_NO_EXCEPTIONが設定されます。
異常終了した場合は、env構造体の_majorにはCORBA_SYSTEM_EXCEPTIONが設定され、_idと_minorに詳細情報が設定されます。

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

1.3.3 CORBA_BOA_get_id()