OpenTP1 Version 7 Programming Reference C Language
dc_rpc_discard_further_replies - Reject the receiving of processing results
Format
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; |
Description
The function dc_rpc_discard_further_replies() specifies that no more responses (which have not been returned) will be received through an asynchronous-response-type RPC (DCRPC_NOWAIT specified for flags of the function dc_rpc_call()). After the function dc_rpc_discard_further_replies() is called, returned responses are discarded instead of being received.
To stop receiving further processing results of an asynchronous-response-type RPC, call the function dc_rpc_discard_further_replies(). Otherwise, the function dc_rpc_poll_any_replies() might receive unnecessary responses.
Use the function dc_rpc_discard_further_replies() in the following cases:
Argument whose value is set in the UAP
flags
Specify DCNOFLAGS.
Return value
There is no return value of the function dc_rpc_discard_further_replies().
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.