名前

tpopen()−リソース・マネージャをオープンするルーチン

形式

#include <atmi.h> 
int tpopen(void) 

機能説明

tpopen() は、呼び出し元がリンクされるリソース・マネージャをオープンします。呼び出し元には、多くとも 1 つのリソース・マネージャしかリンクできません。この関数はリソース・マネージャ固有の open() 呼び出しの代わりに使用するもので、これにより、移植性を損なう可能性のある呼び出しをサービス・ルーチンからなくすことができます。リソース・マネージャは初期化の内容がそれぞれで異なるため、個々のリソース・マネージャをオープンするために必要な情報をコンフィギュレーション・ファイルに記述します。

リソース・マネージャがすでにオープンされている場合 (すなわち、tpopen() を 2 回以上呼び出した場合)、何も処理は行われず、正常終了を示すコードが返されます。

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

戻り値

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

エラー

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

関連項目