ページの先頭行へ戻る
Interstage Application Server リファレンスマニュアル(API編)
Interstage
第1章 C言語インタフェース > 1.17 イベントサービスインタフェース > 1.17.2 CosEventChannelAdminインタフェース
前次

1.17.2 CosEventChannelAdminインタフェース

1.17.2.1 CosEventChannelAdmin_EventChannel_for_consumers()

名前

CosEventChannelAdmin_EventChannel_for_consumers

形式

#include  <EventService.h> 
CosEventChannelAdmin_ConsumerAdmin
CosEventChannelAdmin_EventChannel_for_consumers(
              CosEventChannelAdmin_EventChannel  obj, 
              CORBA_Environment                  *env );

機能説明

コンシューマから、イベントチャネルのオブジェクトリファレンスを獲得します。
このメソッドはオブジェクトリファレンスを格納する領域を獲得するため、この領域が不要になった時点で、CORBA_Object_release()を使用して領域を解放する必要があります。

パラメタ

obj

接続するイベントチャネルのオブジェクトリファレンス。

env

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

復帰値

正常終了した場合は、env構造体の_majorにCORBA_NO_EXCEPTIONが設定されます。
異常終了した場合は、env構造体の_majorにCORBA_SYSTEM_EXCEPTIONが設定され、env構造体の_idに詳細情報が設定されます。

システム例外の場合、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、設定されたシステム例外およびマイナーコードに対する対処を行ってください。

1.17.2.2 CosEventChannelAdmin_EventChannel_for_suppliers()

名前

CosEventChannelAdmin_EventChannel_for_suppliers

形式

#include  <EventService.h> 
CosEventChannelAdmin_SupplierAdmin
CosEventChannelAdmin_EventChannel_for_suppliers(
              CosEventChannelAdmin_EventChannel  obj, 
              CORBA_Environment                  *env );

機能説明

サプライヤから、イベントチャネルのオブジェクトリファレンスを獲得します。
このメソッドはオブジェクトリファレンスを格納する領域を獲得するため、この領域が不要になった時点で、CORBA_Object_release()を使用して領域を解放する必要があります。

パラメタ

obj

接続するイベントチャネルのオブジェクトリファレンス。

env

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

復帰値

正常終了した場合は、env構造体の_majorにCORBA_NO_EXCEPTIONが設定されます。
異常終了した場合は、env構造体の_majorにCORBA_SYSTEM_EXCEPTIONが設定され、env構造体の_idに詳細情報が設定されます。

システム例外の場合、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、設定されたシステム例外およびマイナーコードに対する対処を行ってください。

1.17.2.3 CosEventChannelAdmin_EventChannel_destroy()

名前

CosEventChannelAdmin_EventChannel_destroy

形式

#include  <EventService.h> 
void  CosEventChannelAdmin_EventChannel_destroy(
              CosEventChannelAdmin_EventChannel  obj, 
              CORBA_Environment                  *env );

機能説明

objで指定されたイベントチャネルを破壊します。

パラメタ

obj

破棄するイベントチャネルのオブジェクトリファレンス。

env

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

復帰値

正常終了した場合は、env構造体の_majorにCORBA_NO_EXCEPTIONが設定されます。
異常終了した場合は、env構造体の_majorにCORBA_SYSTEM_EXCEPTIONが設定され、env構造体の_idに詳細情報が設定されます。

システム例外の場合、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、設定されたシステム例外およびマイナーコードに対する対処を行ってください。

1.17.2.4 CosEventChannelAdmin_ConsumerAdmin_obtain_push_supplier()

名前

CosEventChannelAdmin_ConsumerAdmin_obtain_push_supplier

形式

#include  <EventService.h> 
CosEventChannelAdmin_ProxyPushSupplier
CosEventChannelAdmin_ConsumerAdmin_obtain_push_supplier(
              CosEventChannelAdmin_ConsumerAdmin  obj, 
              CORBA_Environment                   *env );

機能説明

イベントチャネルにPushモデルのコンシューマを接続するための、イベントチャネルへのオブジェクトリファレンスを獲得します。
このメソッドはオブジェクトリファレンスを格納する領域を獲得するため、この領域が不要になった時点で、CORBA_Object_release()を使用して領域を解放する必要があります。

パラメタ

obj

CosEventChannelAdmin_EventChannel_for_consumers()が返すオブジェクトリファレンス。

env

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

復帰値

正常終了した場合は、env構造体の_majorにCORBA_NO_EXCEPTIONが設定されます。
異常終了した場合は、env構造体の_majorにCORBA_SYSTEM_EXCEPTIONが設定され、env構造体の_idに詳細情報が設定されます。

システム例外の場合、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、設定されたシステム例外およびマイナーコードに対する対処を行ってください。

1.17.2.5 CosEventChannelAdmin_ConsumerAdmin_obtain_pull_supplier()

名前

CosEventChannelAdmin_ConsumerAdmin_obtain_pull_supplier

形式

#include  <EventService.h> 
CosEventChannelAdmin_ProxyPullSupplier
CosEventChannelAdmin_ConsumerAdmin_obtain_pull_supplier(
              CosEventChannelAdmin_ConsumerAdmin  obj, 
              CORBA_Environment                   *env );

機能説明

イベントチャネルにPullモデルのコンシューマを接続するための、イベントチャネルへのオブジェクトリファレンスを獲得します。
このメソッドはオブジェクトリファレンスを格納する領域を獲得するため、この領域が不要になった時点で、CORBA_Object_release()を使用して領域を解放する必要があります。

パラメタ

obj

CosEventChannelAdmin_EventChannel_for_consumers()が返すオブジェクトリファレンス。

env

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

復帰値

正常終了した場合は、env構造体の_majorにCORBA_NO_EXCEPTIONが設定されます。
異常終了した場合は、env構造体の_majorにCORBA_SYSTEM_EXCEPTIONが設定され、env構造体の_idに詳細情報が設定されます。

システム例外の場合、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、設定されたシステム例外およびマイナーコードに対する対処を行ってください。

1.17.2.6 CosEventChannelAdmin_SupplierAdmin_obtain_push_consumer()

名前

CosEventChannelAdmin_SupplierAdmin_obtain_push_consumer

形式

#include  <EventService.h> 
CosEventChannelAdmin_ProxyPushConsumer
CosEventChannelAdmin_SupplierAdmin_obtain_push_consumer(
              CosEventChannelAdmin_SupplierAdmin  obj, 
              CORBA_Environment                   *env );

機能説明

イベントチャネルにPushモデルのサプライヤを接続するための、イベントチャネルへのオブジェクトリファレンスを獲得します。
このメソッドはオブジェクトリファレンスを格納する領域を獲得するため、この領域が不要になった時点で、CORBA_Object_release()を使用して領域を解放する必要があります。

パラメタ

obj

CosEventChannelAdmin_EventChannel_for_suppliers()が返すオブジェクトリファレンス。

env

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

復帰値

正常終了した場合は、env構造体の_majorにCORBA_NO_EXCEPTIONが設定されます。
異常終了した場合は、env構造体の_majorにCORBA_SYSTEM_EXCEPTIONが設定され、env構造体の_idに詳細情報が設定されます。

システム例外の場合、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、設定されたシステム例外およびマイナーコードに対する対処を行ってください。

1.17.2.7 CosEventChannelAdmin_SupplierAdmin_obtain_pull_consumer()

名前

CosEventChannelAdmin_SupplierAdmin_obtain_pull_consumer

形式

#include  <EventService.h> 
CosEventChannelAdmin_ProxyPullConsumer
CosEventChannelAdmin_SupplierAdmin_obtain_pull_consumer(
              CosEventChannelAdmin_SupplierAdmin  obj, 
              CORBA_Environment                   *env );

機能説明

イベントチャネルにPullモデルのサプライヤを接続するための、イベントチャネルへのオブジェクトリファレンスを獲得します。
このメソッドはオブジェクトリファレンスを格納する領域を獲得するため、この領域が不要になった時点で、CORBA_Object_release()を使用して領域を解放する必要があります。

パラメタ

obj

CosEventChannelAdmin_EventChannel_for_suppliers()が返すオブジェクトリファレンス。

env

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

復帰値

正常終了した場合は、env構造体の_majorにCORBA_NO_EXCEPTIONが設定されます。
異常終了した場合は、env構造体の_majorにCORBA_SYSTEM_EXCEPTIONが設定され、env構造体の_idに詳細情報が設定されます。

システム例外の場合、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、設定されたシステム例外およびマイナーコードに対する対処を行ってください。

1.17.2.8 CosEventChannelAdmin_ProxyPushConsumer_connect_push_supplier()

名前

CosEventChannelAdmin_ProxyPushConsumer_connect_push_supplier

形式

#include  <EventService.h> 
void  CosEventChannelAdmin_ProxyPushConsumer_connect_push_supplier(
              CosEventChannelAdmin_ProxyPushConsumer  obj, 
              CosEventComm_PushSupplier               push_supplier, 
              CORBA_Environment                       *env );

機能説明

イベントチャネルにPushモデルのサプライヤを接続します。

パラメタ

obj

CosEventChannelAdmin_SupplierAdmin_obtain_push_consumer()が返すオブジェクトリファレンス。

push_supplier

サプライヤ自身のオブジェクトリファレンス。
イベントチャネルが終了した場合の切断通知が不要な場合は、CORBA_OBJECT_NILを指定します。

env

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

復帰値

正常終了した場合は、env構造体の_majorにCORBA_NO_EXCEPTIONが設定されます。
異常終了した場合は、env構造体の_majorにCORBA_SYSTEM_EXCEPTIONまたはCORBA_USER_EXCEPTIONが設定され、env構造体の_idに詳細情報が設定されます。

ユーザ例外の場合、以下の詳細情報が設定されます。

ex_CosEventChannelAdmin_AlreadyConnected

イベントチャネルがすでに接続されています。

システム例外の場合、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、設定されたシステム例外およびマイナーコードに対する対処を行ってください。

注意事項

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

1.17.2.9 CosEventChannelAdmin_ProxyPullSupplier_connect_pull_consumer()

名前

CosEventChannelAdmin_ProxyPullSupplier_connect_pull_consumer

形式

#include  <EventService.h> 
void  CosEventChannelAdmin_ProxyPullSupplier_connect_pull_consumer(
              CosEventChannelAdmin_ProxyPullSupplier  obj, 
              CosEventComm_PullConsumer               pull_consumer, 
              CORBA_Environment                       *env );

機能説明

イベントチャネルにPullモデルのコンシューマを接続します。

パラメタ

obj

CosEventChannelAdmin_ConsumerAdmin_obtain_pull_supplier()が返すオブジェクトリファレンス。

pull_consumer

コンシューマ自身のオブジェクトリファレンス。
イベントチャネルが終了した場合の切断通知が不要な場合は、CORBA_OBJECT_NILを指定します。

env

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

復帰値

正常終了した場合は、env構造体の_majorにCORBA_NO_EXCEPTIONが設定されます。
異常終了した場合は、env構造体の_majorにCORBA_SYSTEM_EXCEPTIONまたはCORBA_USER_EXCEPTIONが設定され、env構造体の_idに詳細情報が設定されます。

ユーザ例外の場合、以下の詳細情報が設定されます。

ex_CosEventChannelAdmin_AlreadyConnected

イベントチャネルがすでに接続されています。

システム例外の場合、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、設定されたシステム例外およびマイナーコードに対する対処を行ってください。

注意事項

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

1.17.2.10 CosEventChannelAdmin_ProxyPullConsumer_connect_pull_supplier()

名前

CosEventChannelAdmin_ProxyPullConsumer_connect_pull_supplier

形式

#include  <EventService.h> 
void  CosEventChannelAdmin_ProxyPullConsumer_connect_pull_supplier(
              CosEventChannelAdmin_ProxyPullConsumer  obj, 
              CosEventComm_PullSupplier               pull_supplier, 
              CORBA_Environment                       *env );

機能説明

イベントチャネルにPullモデルのサプライヤを接続します。

パラメタ

obj

CosEventChannelAdmin_SupplierAdmin_obtain_pull_consumer()が返すオブジェクトリファレンス。

pull_supplier

サプライヤ自身のオブジェクトリファレンス。

env

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

復帰値

正常終了した場合は、env構造体の_majorにCORBA_NO_EXCEPTIONが設定されます。
異常終了した場合は、env構造体の_majorにCORBA_SYSTEM_EXCEPTIONまたはCORBA_USER_EXCEPTIONが設定され、env構造体の_idに詳細情報が設定されます。

ユーザ例外の場合、以下の詳細情報が設定されます。

ex_CosEventChannelAdmin_AlreadyConnected

イベントチャネルがすでに接続されています。

ex_CosEventChannelAdmin_TypeError

指定したオブジェクトの型に誤りがあります。

システム例外の場合、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、設定されたシステム例外およびマイナーコードに対する対処を行ってください。

注意事項

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

1.17.2.11 CosEventChannelAdmin_ProxyPushSupplier_connect_push_consumer()

名前

CosEventChannelAdmin_ProxyPushSupplier_connect_push_consumer

形式

#include  <EventService.h> 
void  CosEventChannelAdmin_ProxyPushSupplier_connect_push_consumer(
              CosEventChannelAdmin_ProxyPushSupplier  obj, 
              CosEventComm_PushConsumer               push_consumer, 
              CORBA_Environment                       *env );

機能説明

イベントチャネルにPushモデルのコンシューマを接続します。

パラメタ

obj

CosEventChannelAdmin_ConsumerAdmin_obtain_push_supplier()が返すオブジェクトリファレンス。

push_consumer

コンシューマ自身のオブジェクトリファレンス

env

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

復帰値

正常終了した場合は、env構造体の_majorにCORBA_NO_EXCEPTIONが設定されます。
異常終了した場合は、env構造体の_majorにCORBA_SYSTEM_EXCEPTIONまたはCORBA_USER_EXCEPTIONが設定され、env構造体の_idに詳細情報が設定されます。

ユーザ例外の場合、以下の詳細情報が設定されます。

ex_CosEventChannelAdmin_AlreadyConnected

イベントチャネルがすでに接続されています。

ex_CosEventChannelAdmin_TypeError

指定したオブジェクトの型に誤りがあります。

システム例外の場合、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、設定されたシステム例外およびマイナーコードに対する対処を行ってください。

注意事項

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

1.17.2.12 継承されて使用できるインタフェース

以下のインタフェースを継承して使用することができます。詳細については“1.17.1 CosEventCommインタフェース”を参照してください。

  1. CosEventChannelAdmin_ProxyPushConsumer_push

  2. CosEventChannelAdmin_ProxyPushConsumer_disconnect_push_consumer

  3. CosEventChannelAdmin_ProxyPushSupplier_disconnect_push_supplier

  4. CosEventChannelAdmin_ProxyPullSupplier_pull

  5. CosEventChannelAdmin_ProxyPullSupplier_try_pull

  6. CosEventChannelAdmin_ProxyPullSupplier_disconnect_pull_supplier

  7. CosEventChannelAdmin_ProxyPullConsumer_disconnect_pull_consumer

前次
Copyright 2011-2012 FUJITSU LIMITED