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

1.17.3.3 EventFactory_get_event_channel()

名前

  EventFactory_get_event_channel

形式

  #include  <EventService.h> 
  CosEventChannelAdmin_EventChannel
       EventFactory_get_event_channel(
           EventFactory        obj,
           CORBA_string        key,
           CORBA_Environment   *env );

機能説明

　keyで指定されたイベントチャネルのオブジェクトリファレンスを獲得します。

パラメタ

　obj

　CORBA_ORB_resolve_initial_references()のidentifierパラメタに“EventFactory_ObjectId_Factory”を指定して獲得したオブジェクトリファレンス。

　key

　獲得するイベントチャネル名。

　env

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

復帰値

　正常終了した場合は、env構造体の_majorにCORBA_NO_EXCEPTIONが設定され、keyで指定されたイベントチャネルのオブジェクトリファレンスが返されます。
　異常終了した場合は、env構造体の_majorにCORBA_SYSTEM_EXCEPTIONが設定され、env構造体の_idにシステム例外が設定されます。

　ユーザ例外の場合、以下の例外が設定されます。

　IDL:EventFactory/ChannelNotFound:1.0

　指定されたイベントチャネルは存在しません。

　システム例外の場合、以下の例外が設定されます。

　ex_CORBA_StExcep_COMM_FAILURE

　通信異常が発生しました。

　ex_CORBA_StExcep_NO_IMPLEMENT

　イベントファクトリが起動されていません。