#include <dcvxatmi.h>
DCLONG tpconnect(char *svc, char *data, DCLONG len,
DCLONG flags)
#include <dcvxatmi.h>
DCLONG tpconnect(char CLTFAR *svc, char CLTFAR *data, DCLONG len,
DCLONG flags)
TP1/Clientと会話型サービスとの間に,コネクションを確立します。確立するコネクションは,半二重型です。関数が正常に処理されると,コネクションを指定するための記述子がリターンされます。
コネクションの確立処理時に,tpconnect関数を発行する側は,受信する側のサービス関数に,指定した情報を渡すことができます。発行する側が情報を渡す場合は,dataにtpalloc関数で割り当てたバッファへのポインタを指定し,lenに送信データの長さを指定します。
会話型サービスをするときに,データを受信するための関数を呼び出さないで,情報を受け取れます。
正常に完了した場合,tpconnect関数は,確立したコネクションを指定するための記述子をリターンします。エラー時には,-1をリターンし,リターン値としてエラー情報を示す次のどれか一つの値を,tperrnoに設定します。
リターン値 | 意味 |
---|---|
TPEINVAL | 引数に誤りがあります。 |
TPENOENT | 引数に指定された値は,システムで定義されていないため,コネクションを確立できません。 |
TPEITYPE | 引数に指定されている値は,指定したサービスでは使用できません。 |
TPELIMIT | 未解決のコネクションが最大数に達したので,呼び出し側の要求は送信されません。 |
TPETRAN | 指定したサービスがトランザクション処理ができないサーバに属しているのに,TPNOTRANが指定されていません。 |
TPETIME | タイムアウトが発生しました。
|
TPEBLOCK | TPNOBLOCKを指定したtpconnect関数を呼び出したときに,ブロッキング状態になりました。 |
TPGOTSIG | シグナルは受信されましたが,TPSIGRSTRTが指定されていません。 |
TPEPROTO | tpconnect関数を呼び出すときの状態が適切ではありません。 |
TPESYSTEM | コミュニケーションリソースマネジャでエラーが発生しました。 |
TPEOS | オペレーティングシステムでエラーが発生しました。 |