1.18.2 QoSAdminインタフェース

名前

CosNotification_QoSAdmin_get_qos

形式

#include  <NotificationService.h>
CosNotification_QoSProperties  *
CosNotification_QoSAdmin_get_qos(
              CosNotification_QoSAdmin  obj, 
              CORBA_Environment         *env );

機能説明

QoSPropertiesを獲得します。QoSPropertiesの詳細については、“アプリケーション作成ガイド（イベントサービス編）”の“QoS機能運用時のアプリケーション開発”を参照してください。
このメソッドはQoSPropertiesの領域を獲得するため、この領域が不要になった時点で、CORBA_free()を使用して領域を解放する必要があります。

パラメタ

obj: イベントチャネルのオブジェクトリファレンス。

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

復帰値

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

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

名前

CosNotification_QoSAdmin_set_qos

形式

#include  <NotificationService.h>
void
CosNotification_QoSAdmin_set_qos(
              CosNotification_QoSAdmin         obj,
              CosNotification_QoSProperties    *qos,
              CORBA_Environment                *env );

機能説明

QoSPropertiesを設定します。QoSPropertiesの詳細については、“アプリケーション作成ガイド（イベントサービス編）”の“QoS機能運用時のアプリケーション開発”を参照してください。

パラメタ

obj: イベントチャネルのオブジェクトリファレンス。

qos: 設定するQoSProperties。

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

復帰値

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

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

ex_CosNotification_UnsupportedQoS: 指定されたQoSプロパティ項目またはその値に誤りがあります。

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

1.18.2 QoSAdminインタフェース

1.18.2.1 CosNotification_QoSAdmin_get_qos()

1.18.2.2 CosNotification_QoSAdmin_set_qos()