名前

tpgetctxt()−現在のアプリケーション関連のコンテキスト識別子の取得

形式

#include <atmi.h>
int tpgetctxt(TPCONTEXT_T *context, long flags)

機能説明

tpgetctxt() は、現在のアプリケーション・コンテキストを表す識別子を取り出し、context に入れます。この関数は、マルチスレッド環境ではスレッド単位で、非スレッド環境ではプロセス単位で動作します。

一般にスレッドは、以下の動作を行います。

2 番目の引数 flags は現在使用されていないので、0 に設定します。

tpgetctxt() は、マルチコンテキストのアプリケーションだけでなく、シングルコンテキストのアプリケーションでも呼び出すことができます。

マルチスレッドのアプリケーション中のスレッドは、TPINVALIDCONTEXT を含め、どのコンテキスト状態で実行していても、tpgetctxt() の呼び出しを発行できます。

戻り値

正常終了時には、tpgetctxt() は負数でない値を返します。コンテキストは、以下のいずれかの形式で表される現在のコンテキスト ID に設定されます。

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

エラー

異常終了時には、tpgetctxt() は tperrno を次のいずれかの値に設定します。

関連項目