| SYNOPSIS | 
#include <libmilter/mfapi.h>
int smfi_setreply(
	SMFICTX *ctx,
	char *rcode,
	char *xcode,
	char *message
);
Set the default SMTP error reply code.  Only 4XX and 5XX replies are accepted. | 
|---|
| DESCRIPTION | 
| Called When | smfi_setreply may be called from any of the xxfi_ callbacks
other than xxfi_connect. |  
| Effects | Directly set the SMTP error reply code for this connection.  This code 
will be used on subsequent error replies resulting from actions taken by 
this filter. |  | 
|---|
| ARGUMENTS | 
    | Argument | Description | 
|---|
 | ctx | Opaque context structure. |  | rcode | The three-digit (RFC 821/2821) SMTP reply code, as a
	null-terminated string.  rcode cannot be NULL, and must be a valid
	4XX or 5XX reply code. |  | xcode | The extended (RFC 1893/2034) reply code.  If xcode is NULL, no
	extended code is used.  Otherwise, xcode must conform to RFC 1893/2034. |  | message | The text part of the SMTP reply.  If message is NULL, an empty message is used. |  | 
|---|
| RETURN VALUES | smfi_setreply will fail and return MI_FAILURE if: 
    Otherwise, it return MI_SUCCESS.The rcode or xcode argument is invalid.
    A memory-allocation failure occurs.
 | 
| NOTES | 
Values passed to smfi_setreply are not checked for standards compliance.
For details about reply codes and their meanings, please see RFC's 
821/
2821
and
1893/
2034.
If the reply code (rcode) given is a '4XX' code but SMFI_REJECT is used
for the message, the custom reply is not used.
Similarly, if the reply code (rcode) given is a '5XX' code but
SMFI_TEMPFAIL is used for the message, the custom reply is not used.
 |