2.18.1 OTS::init

名前

OTS::init

形式

#include  "OTS_cplus.h"
void    OTS::init(
              CORBA::ORB_ptr           orb,
              char                    *impl,
              CORBA::Environment& env);

機能説明

サーバアプリケーションとOTSを接続します。implにはサーバアプリケーションのインプリメンテーションリポジトリIDを指定します。
OTSインタフェースのオブジェクトリファレンスは、CORBA::ORB::resolve_initial_referencesメソッド(CORBA::ORB::ObjectId_TransactionServerInit)で取得します。

パラメタ

orb: CORBA::ORB_initメソッドで獲得したCORBA::ORB_ptrを指定します。

impl: サーバアプリケーションのインプリメンテーションリポジトリID文字列を参照するポインタを指定します。

env: 例外情報を獲得するためにCORBA::Environmentオブジェクトを指定します。

復帰値

正常終了した場合は、envのexceptionメンバにNULLオブジェクトリファレンスが設定されます。異常終了した場合は、envのexceptionメンバにSystemExceptionまたは UserExceptionオブジェクトのオブジェクトリファレンスが設定されます。

UserExceptionの場合は以下の例外クラスが通知されます。

OTS::Bad_Description：: リソース定義ファイルの記述に誤りがあります。

OTS::No_DefFile：

リソース定義ファイルが存在しません。または、インプリメンテーション

リポジトリにリソース定義ファイル名が指定されていません。

OTS::Rm_Error：: データベースのオープンで一時的エラーが発生しました。

OTS::Permission_Denied：: リソース定義ファイルのパーミッションがありません。

OTS::IOError：: リソース定義ファイルの読込中にI/Oエラーが発生しました。

注意事項

本関数は、1プロセスで2回以上呼び出さないでください。