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

1.17.3.1 EventFactory_create()

名前

  EventFactory_create

形式

  #include  <EventService.h> 
  CosEventChannelAdmin_EventChannel EventFactory_create(
                EventFactory                obj, 
                CORBA_string                key, 
                EventFactory_Option         *data, 
                CORBA_Environment           *env ); 
  typedef struct {
        CORBA_long           max_queuing; 
        CORBA_long           life_time; 
        EventFactory_Model   model; 
  } EventFactory_Option;

機能説明

　イベントチャネルを生成し、生成したイベントチャネルのオブジェクトリファレンスを返します。
　keyには、コンシューマ／サプライヤで共通のキーワードを指定します。共通のキーワードを指定することにより同じイベントチャネルを示すオブジェクトリファレンスが返されます。objに指定するオブジェクトリファレンスは、CORBA_ORB_resolve_initial_references()のidentifierパラメタに以下の値を指定して獲得します。

　EventFactory_ObjectId_Factory

　EventFactory_Option構造体の各メンバには以下の値を設定します。

メンバ	設定値
max_queuing	最大データ蓄積数。EventFactory_ES_DEFAULT_VALUEを指定した場合、イベントサービスの構成情報の設定で指定した“イベントチャネルに蓄積できるイベントデータ数の最大値”の値を使用します。
life_time	データ保持時間(秒)。EventFactory_ES_DEFAULT_VALUEを指定した場合、イベントサービスの構成情報の設定で指定した“蓄積したイベントデータの生存時間（秒）”の値を使用します。0を指定した場合、タイムアウト監視は行いません。
model	接続モデルとして以下の値を指定します。 EventFactory_ModelAny　　　　接続時に決定 EventFactory_ModelPush　　　Pushモデル EventFactory_ModelPull　　　Pullモデル EventFactory_ModelMixed　　　Mixedモデル

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

復帰値

　正常終了した場合は、env構造体の_majorにCORBA_NO_EXCEPTIONが設定され、生成されたイベントチャネルのオブジェクトリファレンスが返されます。
　異常終了した場合は、env構造体の_majorにCORBA_SYSTEM_EXCEPTIONが設定され、env構造体の_idに詳細情報が設定されます。
　システム例外の場合、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、設定されたシステム例外およびマイナーコードに対する対処を行ってください。