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

1.19.2.2 ES_ChannelUtil_get_proxys6()

名前

  ES_ChannelUtil_get_proxys6

形式

  #include  <EventService.h>
  ES_ChannelUtil_ProxyData6Seq *
  ES_ChannelUtil_get_proxys6 (
                ES_ChannelUtil              obj, 
                ES_ChannelUtil_ProxyKind    kind, 
                CORBA_Environment           *env );
  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”が入力されます。
　このメソッドはイベントチャネルに接続しているコンシューマ/サプライヤの接続情報を格納する領域を獲得するため、この領域が不要になった時点で、CORBA_free()を使用して領域を解放する必要があります。

パラメタ

　obj

　ES_ChannelUtilのオブジェクトリファレンス。

　kind

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

　env

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

復帰値

　正常終了した場合は、env構造体の_majorにCORBA_NO_EXCEPTIONが設定され、イベントチャネルに接続しているコンシューマ/サプライヤの接続情報を返します。
　異常終了した場合は、env構造体の_majorにCORBA_SYSTEM_EXCEPTIONまたはCORBA_USER_EXCEPTIONが設定され、env構造体の_idに詳細情報が設定されます。

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

　ex_CORBA_StExcep_COMM_FAILURE

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

　ex_CORBA_StExcep_NO_IMPLEMENT

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

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