dc_rpc_discard_specific_reply - Reject acceptance of particular processing results

ANSI C, C++

#include <dcrpc.h>
int  dc_rpc_discard_specific_reply (int des, DCLONG flags)

K&R C

#include <dcrpc.h>
int  dc_rpc_discard_specific_reply (des, flags)
int        des;
DCLONG     flags;

The function dc_rpc_discard_specific_reply indicates that the UAP will no longer receive a specific response which can be returned by an asynchronous-response type RPC (when DCRPC_NOWAIT was specified in flags in the function dc_rpc_call) but has not yet been returned. To specify the asynchronous response whose reception is to be rejected, specify the descriptor returned when an asynchronous-response type RPC returned in des. Of the responses that return after this function is called, responses having the same descriptor as the specified descriptor are discarded without being received.

des

Specify the descriptor returned when the function dc_rpc_call (with DCRPC_NOWAIT specified in flags) of an asynchronous-response type RPC terminated normally.

flags

Specify DCNOFLAGS.

Return value	Return value (numeric)	Explanation
DC_OK	0	Normal termination.
DCRPCER_INVALID_ARGS	-301	The value specified for the argument is invalid.
DCRPCER_PROTO	-302	The function dc_rpc_open was not called.
DCRPCER_INVALID_DES	-322	The descriptor specified for des does not exist. An asynchronous-response type RPC corresponding to the specified descriptor was not sent, or a response has already been received through an asynchronous-response type RPC, or reception of a response was rejected.