tpgetrply(3c)

名前

tpgetrply()-以前の要求に対する応答を受信するためのルーチン

形式

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

機能説明

tpgetrply() は、以前に送られた要求に対する応答を返します。この関数の最初の引数 cd は、tpacall() が返す呼び出し記述子を指します。デフォルトの設定では、この関数は、*cd と一致する応答が届くか、タイムアウトが発生するまで処理を進めません。

data は、以前に tpalloc() で割り当てたバッファを指すポインタのアドレスでなければならず、len は tpgetrply() が正常に受信したデータ量を設定する long 型の値を指すようにしてください。正常終了時には、*data その応答を収めたバッファを指し、*len にはそのデータのサイズが入ります。FML と FML32 バッファは、通常最小サイズ 4096 バイトを確保します。応答が 4096 バイトより大きい場合には、バッファ・サイズは返されるデータを入れるのに十分な大きさに拡大します。 リリース 6.4 では、バッファに対するデフォルトの割り当ては 1024 バイトです。また、最近使用したバッファの履歴情報が保持され、最適サイズのバッファをリターン・バッファとして再利用できます。

容量まで満たされていないかもしれない送信者側のバッファ (たとえば、FML または FML32 バッファ) は、送信に使用されたサイズになります。システムは、受信データのサイズを任意の量で拡大します。これは、受信者が送信者の割り当てたバッファ・サイズより小さく、送信されたデータのサイズより大きいバッファを受け取ることを意味します。

返されたときに *len が 0 の場合は、応答にはデータ部分がなく、*data やそれが指示するバッファは変更されていません。

*data または len が NULL であるとエラーになります。

マルチスレッド・プログラムの各コンテキスト内では、次の条件があります。

これらの制限のどちらかに違反する tpgetrply() 呼び出しを発行した場合は、-1 が返され、tperrno は TPEPROTO に設定されます。

次のような呼び出しの発行は受け付けられます。

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

後に示す場合以外は、*cd はその応答を受信した後は有効でなくなります。

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

戻り値

tpgetrply() から正常に終了した場合、あるいは tperrno() が TPESVCFAIL に設定された状態で終了した場合、tpurcode() には、tpreturn() の一部として送信されたアプリケーション定義値が入ります。

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

エラー

関連項目