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

1.3.4 CORBA_BOA_set_exception()

名前

　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構造体のポインタを指定する必要があります。