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

3.21.5.1 org.omg.CosNotifyChannelAdmin.EventChannelFactory.create_channel()

名前

  org.omg.CosNotifyChannelAdmin.EventChannelFactory.create_channel

形式

  import  org.omg.CosNotifyChannelAdmin.*; 
  public  interface EventChannelFactory extends org.omg.CORBA.Object {
        public  org.omg.CosNotifyChannelAdmin.EventChannel create_channel ( 
              org.omg.CosNotification.Property[]  initial_qos,
              org.omg.CosNotification.Property[]  initial_admin,
              org.omg.CORBA.IntHolder             id )
                  throws org.omg.CosNotification.UnsupportedQoS,
                         org.omg.CosNotification.UnsupportedAdmin;
  }

機能説明

　initial_qos, initial_adminで指定されたQoSプロパティ項目およびAdminプロパティ項目を持つイベントチャネルを生成し、イベントチャネルのオブジェクトリファレンスを返します。QoSプロパティ項目およびAdminプロパティ項目の詳細については、“アプリケーション作成ガイド（イベントサービス編）”の“基礎知識”−“ノーティフィケーションサービスのプロパティ”を参照してください。
　ファクトリのオブジェクトリファレンスは、org.omg.CORBA.ORB.resolve_initial_references()メソッドのidentifierパラメタに以下の値を指定して獲得します。
　　"NotificationService"

パラメタ

　initial_qos

　イベントチャネルを生成するQoSプロパティ項目。

　initial_admin

　イベントチャネルを生成するAdminプロパティ項目。

　id（outパラメタ）

　イベントチャネルの識別IDが設定されます。

復帰値

　正常終了した場合は、イベントチャネルのオブジェクトリファレンスを返します。
　異常終了した場合は、例外が発生します。

　ユーザ例外の場合は、以下の例外が発生します。

　org.omg.CosNotification.UnsupportedQoS

　指定されたQoSプロパティ項目またはその値に誤りがあります。

　org.omg.CosNotification.UnsupportedAdmin

　指定されたAdminプロパティ項目またはその値に誤りがあります。

　システム例外の場合は、以下の例外が発生します。

　org.omg.CORBA.NO_RESOURCES

　以下のいずれかの可能性があります。
　−　作成可能なイベントチャネル数の最大値に達した。
　−　イベントファクトリが閉塞終了中である。

　org.omg.CORBA.COMM_FAILURE

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

　org.omg.CORBA.NO_IMPLEMENT

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