ee_rpc_discard_further_replies
- 〈このページの構成〉
形式
ANSI C,C++の形式
#include <eerpc.h> int ee_rpc_discard_further_replies(EELONG flags)
機能
非同期応答型RPC(ee_rpc_call関数のflagsにEERPC_NOWAITを設定)で,返ってきていない応答を,これ以上受信しないことを示す関数です。この関数を呼び出したあとは,応答が返ってきても受信しないで捨てられます。
非同期応答型RPCの結果をこれ以上受信しない場合は,必ずee_rpc_discard_further_replies関数を呼び出してください。呼び出さないと,ee_rpc_poll_any_replies関数が不要な応答を受信してしまうことがあります。
ee_rpc_discard_further_replies関数を使う場合を次に示します。
-
応答待ち時間切れになったあと,結果を保持しておくバッファを解放する場合
-
非同期応答型RPCを複数回使って,そのうちの最初の応答だけ必要な場合
UAPで値を設定する引数
●flags
EENOFLAGSを設定します。
リターン値
ここで示すリターン値は,TP1/EEが返す値です。サービス関数から返される値ではありません。
リターン値 |
意味 |
---|---|
EE_OK |
正常に終了しました。 |
EECOMER_CNDBPP |
オフラインバッチプロセスから発行しているため,この機能は使用できません。 |
EECOMER_CNDUOC |
UOCから発行しているため,この機能は使用できません。 |
EECOMER_ENVIRON |
TP1/EEの環境下にありません。 |
EERPCER_ARGUMENT |
引数に設定した値が間違っています。 |
EERPCER_CONDITION |
発行条件が不正です。 |