1.3.1 CORBA_BOA

名前

CORBA_BOA_create

形式

  #include <orb.h>
  CORBA_Object CORBA_BOA_create(
        CORBA_BOA  boa,
        CORBA_ReferenceData  *ref,
        CORBA_InterfaceDef  intf, 
        CORBA_ImplementationDef  impl,
        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;
  typedef  CORBA_Object  CORBA_InterfaceDef;
  typedef  CORBA_Object  CORBA_ImplementationDef;

機能説明

  オブジェクトリファレンスを生成して返します。

  また、以下の条件の場合に生成するオブジェクトリファレンスにコード系情報が付加されます。
  1) OD_impl_instコマンドでコード情報を設定した場合
  2) OD_set_envコマンドでコード情報を設定した場合

  サーバアプリケーションでオブジェクトリファレンスを作成する場合、OD_or_admコマンドで-Lオプションを省略した場合と同様のコード系が設定されます。

ここで生成したオブジェクトリファレンスを破壊するには、CORBA_BOA_dispose()を使用します。また、オブジェクトリファレンスのメモリを解放するには、CORBA_Object_release()を使用します。

パラメタ

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

ref: サーバアプリケーションがオブジェクト生成時に設定するオブジェクトの識別情報を指定します。識別情報は、CORBA_sequence_octet構造体の_bufferに設定します。この値は、オブジェクトが破壊されるまで変化しません。

intf: 生成するオブジェクトのインタフェース情報を管理するインタフェースリポジトリのオブジェクトリファレンスを指定します。

impl: implには、生成するオブジェクトの実装情報を管理するインプリメンテーションリポジトリのオブジェクトリファレンスを指定します。

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

復帰値

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

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

1.3.1 CORBA_BOA_create()