1.3.4 CORBA_BOA_set

名前

CORBA_BOA_set_exception

形式

#include <orb.h>
void  CORBA_BOA_set_exception(
      CORBA_BOA  boa,
      CORBA_unsigned_long  major,
      CORBA_string  user_id,
      void  *param,
      CORBA_Environment  *env );

機能説明

例外情報を設定します。サーバアプリケーションのオペレーションは、復帰する前に当関数を呼び出すことにより、エラー終了することができます。このとき、ここで設定した例外情報がクライアントアプリケーションに返却されます。

パラメタ

boa: CORBA_ORB_BOA_init()で返されたオブジェクトリファレンスを指定します。

major

以下の値が指定できます。

CORBA_SYSTEM_EXCEPTION /* 標準例外 */

CORBA_USER_EXCEPTION /* ユーザ例外 */

user_id: 例外を識別するための識別子。

param: 例外がパラメタをとるように指定されている場合は、例外の付加情報を設定します。

env: オペレーション関数に渡されたenv。

復帰値

なし。

注意事項

最後の引数であるenvの使用方法に注意してください。他APIの場合はAPI自身が異常終了した場合の例外情報が格納されますが、本APIのenvにはサーバのオペレーション関数に渡されたCORBA_Environment構造体のポインタを指定する必要があります。

1.3.4 CORBA_BOA_set_exception()