2.22.4.11 CosNotifyChannelAdmin::StructuredProxyPushConsumer::connect_structured_push

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

目次索引

第2章 C++言語インタフェース

> 2.22 ノーティフィケーションサービスインタフェース

> 2.22.4 CosNotifyChannelAdminモジュール

2.22.4.11 CosNotifyChannelAdmin::StructuredProxyPushConsumer::connect_structured_push_supplier()

名前

  CosNotifyChannelAdmin::StructuredProxyPushConsumer::connect_structured_push_supplier

形式

　#include  <NotificationService_cplus.h>
　void
　CosNotifyChannelAdmin::StructuredProxyPushConsumer::connect_structured_push_supplier(
              CosNotifyComm::StructuredPushSupplier_ptr               push_supplier,
              CORBA::Environment&                                     env );
              throw( CORBA::Exception );

機能説明

　イベントチャネルにStructuredEvent型のサプライヤとして接続します。

パラメタ

　push_supplier: 　自身のオブジェクトリファレンス。
　イベントチャネルが終了した場合の切断通知が不要な場合は、CosNotifyComm::StructuredPushSupplier::_nil()を指定します。
　env: 　例外情報が格納される構造体。

復帰値

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

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

　CosEventChannelAdmin::AlreadyConnected: 　すでにイベントチャネルと接続されています。

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

　CORBA::StExcep::NO_RESOURCES: 　以下のいずれかの可能性があります。
　－　イベントチャネルが閉塞終了中である。
　
　－　イベントチャネルが閉塞／自動閉塞されている。
　CORBA::StExcep::COMM_FAILURE: 　通信異常が発生しました。
　CORBA::StExcep::NO_IMPLEMENT: 　イベントチャネルが起動されていません。

注意事項

　イベントチャネルと再接続する場合は、再度CosNotifyChannelAdmin::SupplierAdmin::obtain_notification_push_consumer()から行ってください。

目次索引