|
|
tpgetctxt(3c)
名前
tpgetctxt()-現在のアプリケーション関連のコンテキスト識別子の取得
形式
#include <atmi.h>
int tpgetctxt(TPCONTEXT_T *context, long flags)
機能説明
tpgetctxt() は、現在のアプリケーション・コンテキストを表す識別子を取り出し、context に入れます。この関数はマルチスレッド環境ではスレッド単位で動作し、非スレッド環境ではプロセス単位で動作します。
一般にスレッドは、以下の動作を行います。
2 番目の引き数 flags は現在使用されていないので、0 に設定します。
tpgetctxt() は、マルチコンテキストのアプリケーションだけでなく、シングルコンテキストのアプリケーションでも呼び出すことができます。
マルチスレッドのアプリケーション中のスレッドは、TPINVALIDCONTEXT を含め、どのコンテキスト状態で実行していても、tpgetctxt() の呼び出しを発行できます。
戻り値
正常終了時には、tpgetctxt() は負数でない値を返します。コンテキストは、以下のいずれかの形式で表される現在のコンテキスト ID に設定されます。
TPINVALIDCONTEXT 状態のスレッドは、ほとんどの ATMI 関数を呼び出すことができません。呼び出せる関数、または呼び出せない関数のリストについては、「C 言語アプリケーション・トランザクション・モニタ・インターフェイスについて」 を参照してください。
TPINVALIDCONTEXT コンテキスト状態の詳細については、tpterm(3c) を参照してください。
異常終了すると、tpgetctxt() は -1 を返し、tperrno を設定してエラー条件を示します。
エラー
異常終了時には、tpgetctxt() は tperrno を次のいずれかの値に設定します。
関連項目
「C 言語アプリケーション・トランザクション・モニタ・インターフェイスについて」、tpsetctxt(3c)、tpterm(3c)
|
Copyright © 2001 BEA Systems, Inc. All rights reserved.
|