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;

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:

• After a response wait timeout occurs, the buffer for shutting down the processing results is released.
• An asynchronous-response-type RPC has been called more than once, but only the first response is necessary.

flags

Specify DCNOFLAGS.

There is no return value of the function dc_rpc_discard_further_replies().