dc_rpc_discard_further_replies
- 〈このページの構成〉
形式
ANSI C ,C++の形式
#include <dcrpc.h> void dc_rpc_discard_further_replies(DCLONG flags)
K&R版 C の形式
#include <dcrpc.h> void dc_rpc_discard_further_replies(flags) DCLONG flags;
機能
非同期応答型RPC(dc_rpc_call関数のflagsにDCRPC_NOWAITを設定)で,まだ返ってきていない応答を,これ以上受信しないことを示す関数です。この関数を呼び出したあとは,応答が返ってきても受信しないで捨てられます。
非同期応答型RPCの結果をこれ以上受信しない場合は,必ずdc_rpc_discard_further_replies関数を呼び出してください。呼び出さないと,dc_rpc_poll_any_replies関数が不要な応答を受信してしまうことがあります。
dc_rpc_discard_further_replies関数を使う場合を次に示します。
-
応答待ち時間切れになったあと,結果を保持しておくバッファを解放する場合
-
非同期応答型RPCを複数回使って,そのうち最初の応答だけ必要な場合
UAPで値を設定する引数
●flags
DCNOFLAGSを設定します。
リターン値
dc_rpc_discard_further_replies関数のリターン値はありません。