名前

tpunsubscribe()−イベントのサブスクリプションを削除する

形式

#include <atmi.h> 
int tpunsubscribe(long subscription, long flags)

機能説明

呼び出し元は tpunsubscribe() を使用して、BEA Tuxedo ATMI のイベント・ブローカのアクティブなサブスクリプションのリストからイベントのサブスクリプションまたはイベントのサブスクリプションの集合を削除します。subscription には、tpsubscribe() が返したイベントのサブスクリプションのハンドルを指定します。subscription をワイルドカード値の -1 に設定すると、tpunsubscribe() が、呼び出し元のプロセスが以前に行ったすべての非持続型のサブスクリプションを削除する指示になります。非持続型のサブスクリプションとは、tpsubscribe() の ctl—>flags パラメータに TPEVPERSIST ビットを設定して行われたサブスクリプションのことです。持続タイプのサブスクリプションは、tpsubscribe() から返されたハンドルを使用することによってのみ削除できます。

ハンドル -1 を指定すると、呼び出し元のプロセスが行ったサブスクリプションのみを削除し、呼び出し元が以前に起動されたときに行ったサブスクリプションは削除しないことに注意してください (たとえば、異常終了した後で再起動したサーバでは、ワイルドカードを使用して以前のサーバが行ったサブスクリプションを削除することはできません)。

次に、有効な flags の一覧を示します。

マルチスレッドのアプリケーションの場合、TPINVALIDCONTEXT 状態のスレッドは、tpunsubscribe() の呼び出しを発行できません。

戻り値

tpunsubscribe() が成功して戻ると、tpurcode() にはイベント・ブローカのアクティブなサブスクリプションのリストから削除されたサブスクリプションの数 (0 または 1 以上) が指定されます。tpurcode() に 1 より大きな数が設定されるのは、ワイルドカードのハンドルを -1 に指定した場合のみです。また、tpunsubscribe() が失敗して終了した場合にも、tpurcode() に 1 より大きな数が設定されることがあります (つまり、ワイルドカードのハンドルを指定して、イベント・ブローカがいくつかのサブスクリプションの削除に成功した後で、他のサブスクリプションを削除する際にエラーが発生したような場合です)。

異常終了すると、tpunsubscribe() は -1 を返し、tperrno を設定してエラー条件を示します。

エラー

異常終了時には、tpunsubscribe() は tperrno を次のいずれかの値に設定します(特に記述した場合を除いては、エラーが呼び出し元のトランザクションに影響を及ぼすことはありません)。

関連項目