NAME
smfi_addrcpt() — adds a recipient for the current sendmail message
SYNOPSIS
#include <libmilter/mfapi.h>
int smfi_addrcpt(
SMFICTX *ctx,
char *rcpt
);
PARAMETERS
- ctx
Specifies the opaque context structure.
- rcpt
Specifies the new address of the recipient.
DESCRIPTION
smfi_addrcpt()
adds a recipient to the message envelope.
smfi_addrcpt()
can be called only from the
xxfi_eom()
routine.
Notes
A filter that calls the
smfi_addrcpt()
function must set the
SMFIF_ADDRCPT
flag in the
smfiDesc_str
structure passed to the
smfi_register()
function.
RETURN VALUE
smfi_addrcpt()
fails and returns
MI_FAILURE
due to the following reasons:
Adding recipients in the current connection state is invalid.
The
SMFIF_ADDRCPT
flag is not set when the
smfi_register()
routine is called.
AUTHOR
smfi_addrcpt()
was developed by the Sendmail Inc.