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

2.23.2.2 ES::ChannelUtil::get_proxys6()

名前

  ES::ChannelUtil::get_proxys6

形式

  #include  <EventService_cplus.h>
  ES::ChannelUtil::ProxyDataSeq  ES::ChannelUtil::get_proxys6 (
                                    ES::ChannelUtil::ProxyType       kind,
                                    CORBA::Environment&              env )
                                   throw( CORBA::Exception );
  typedef struct {
        CORBA::Object              proxy; 
        CORBA::long                time; 
        CORBA::octet               ipaddress[16]; 
        CORBA::long                ip_format;
        ES::ChannelUtil::ProxyKind kind; 
  } ES::ChannelUtil::ProxyData6;
  typedef sequence< ES::ChannelUtil::ProxyData6> ES::ChannelUtil::ProxyData6Seq;

機能説明

　イベントチャネルに接続しているコンシューマ/プライヤの接続情報を取得します。
　ip_formatには、ipaddressがIPv6形式で格納されている場合は“1”が、IPv4形式の場合は“0”が入力されます。
　このメソッドはイベントチャネルに接続しているコンシューマ/サプライヤの接続情報を格納する領域を獲得するため、この領域が不要になった時点で、deleteを使用して領域を解放する必要があります。

パラメタ

　kind

　取得するProxyオブジェクトのタイプ。
　本パラメタに設定する値に応じて、取得する接続情報が異なります。本パラメタに指定した値と復帰値情報の対応については、“ES::ChannelUtil::get_proxys()”の“kind値と復帰値情報の対応”を参照してください。

　env

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

復帰値

　正常終了した場合は、envのexceptionメンバにNULLオブジェクトリファレンスが設定され、イベントチャネルに接続しているコンシューマ/サプライヤの接続情報を返します。
　異常終了した場合は、envのexceptionメンバにSystemExceptionオブジェクト、またはUserExceptionオブジェクトのオブジェクトリファレンスが設定されます。

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

　CORBA::StExcep::COMM_FAILURE

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

　CORBA::StExcep::NO_IMPLEMENT

　イベントチャネルが起動されていません。

　IPv6環境で運用している場合は、IPv4クライアントのメンバ“ipaddress”にはIPv4射影アドレスが格納されます。IPv6環境で運用する設定については、“チューニングガイド”の“Interstageのチューニング”−“IPv6環境での運用について”、および“CORBAサービスの動作環境ファイル”−“config”（IP-versionパラメタ）を参照してください。