Sendmail 8.13.3 Programmer's Guide

Milter APIs
Other Message Handling APIs
Chapter 2 35
The smfi_quarantine() API
You can use the smfi_quarantine() API to quarantine the message
using the specific reason. You can call smfi_quarantine() only from the
xxfi_eom() callback.
The declaration of smfi_quarantine() is as follows:
#include <libmilter/mfapi.h>
int smfi_quarantine(
SMFICTX *ctx;
char *reason;
);
Arguments
You must call smfi_quarantine() with the following arguments:
ctx Specifies an opaque context structure.
reason Specifies the quarantine reason, which is a non-NULL
and non-empty null-terminated string.
Return Values
smfi_quarantine() returns MI_FAILURE on failure because of the
following reasons:
• The reason argument is NULL or empty.
• Network error occurs.
• The SMFIF_QUARANTINE value is not set when the smfi_register()
routine is called.
smfi_quarantine() returns MI_SUCCESS on success.