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

2.22.5.3 CosNotifyChannelAdmin::EventChannelFactory::get_event_channel()

名前

  CosNotifyChannelAdmin::EventChannelFactory::get_event_channel

形式

　#include  <NotificationService_cplus.h>
　CosNotifyChannelAdmin::EventChannel_ptr
　CosNotifyChannelAdmin::EventChannelFactory::get_event_channel(
                          CosNotifyChannelAdmin::ChannelID             id,
                          CORBA::Environment&                          env );
                       throw( CORBA::Exception );

機能説明

　idで指定された識別IDを持つイベントチャネルのオブジェクトリファレンスを返します。
　このメソッドはオブジェクトリファレンスを格納する領域を獲得するため、この領域が不要になった時点で、CORBA::release()を使用して領域を解放する必要があります。

パラメタ

　id

　取得するイベントチャネルの識別ID。

　env

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

復帰値

　正常終了した場合は、envのexceptionメンバにNULLオブジェクトリファレンスが設定され、idで指定された識別IDを持つイベントチャネルのオブジェクトリファレンスを返します。
　異常終了した場合は、envのexceptionメンバにSystemExceptionオブジェクト、またはUserExceptionオブジェクトのオブジェクトリファレンスが設定されます。

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

　CosNotifyChannelAdmin::ChannelNotFound

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

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

　CORBA::StExcep::COMM_FAILURE

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