名前

tpconnect()−会話型サービス・ルーチンの接続を設定するルーチン

形式

#include <atmi.h> 
 
int tpconnect(char *svc, char *data, long len, long flags)

機能説明

tpconnect() により、プログラムは会話型サービス svc との半二重接続をセットアップすることができます。この名前は、会話型サーバがポストした会話型サービス名の 1 つでなければなりません。

呼び出し元は、接続セットアップ処理の一部として、アプリケーション定義データをリスニング・プログラムに渡すことができます。呼び出し元がデータを渡す選択をした場合には、data は tpalloc() が以前に割り当てたバッファを指していなければなりません。len には送信バッファの大きさを指定します。ただし、data が長さの指定を必要としないバッファを指している場合 (FML フィールド化バッファなど)、len は無視されます (0 でかまいません)。また、data は NULL の場合もあります。この場合、len は無視されます (アプリケーション・データは会話型サービスに渡されません)。data のタイプとサブタイプは、svc が認識するタイプおよびサブタイプと一致しなければなりません。data と len は、該当サービスの呼び出し時に使用する TPSVCINFO 構造体を介して会話型サービスに渡されます。また、サービスはこのデータの取得に tprecv() を呼び出す必要はありません。

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

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

戻り値

tpconnect() が正常に終了した場合、以後の呼び出しでの接続を指すのに使用する記述子を返します。エラー時には、-1 を返し、tperrno を設定してエラー条件を示します。

エラー

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

関連項目