| SYNOPSIS | 
#include <libmilter/mfapi.h>
int smfi_quarantine(
	SMFICTX *ctx;
	char *reason;
);
 
Quarantine the message using the given reason.
 | 
| DESCRIPTION | 
| Called When | 
Called only from xxfi_eom. | 
 
| Effects | 
smfi_quarantine quarantines the message using the given reason. | 
 
 
 | 
|---|
| ARGUMENTS | 
    
    | Argument | Description |  
    | ctx | 
	Opaque context structure.
	 |  
    | reason | 
	The quarantine reason, a non-NULL and non-empty null-terminated string.
	 |  
     
 | 
| RETURN VALUES |  
smfi_quarantine will fail and return MI_FAILURE if:
    - reason is NULL or empty.
    
 - A network error occurs.
    
 - SMFIF_QUARANTINE was not set when smfi_register was called.
  
Otherwise, it will return MI_SUCCESS
 |