NAME
smfi_delrcpt() — removes a recipient from envelope of current sendmail message
SYNOPSIS
#include <libmilter/mfapi.h>
int smfi_delrcpt(
SMFICTX *ctx;
char *rcpt;
);
PARAMETERS
- ctx
Specifies the opaque context structure.
- rcpt
Specifies the recipient address to be removed, which is a
non-NULL, null-terminated string.
DESCRIPTION
smfi_delrcpt()
removes the named recipient from the envelope of the current message.
smfi_delrcpt()
can be called only from the
xxfi_eom()
routine.
Notes
The addresses to be removed must match exactly.
For example, if an
address and its expanded form do not match, the address is not
removed.
RETURN VALUE
smfi_delrcpt()
fails and returns
MI_FAILURE
due to the following reasons:
The
rcpt
variable is NULL.
Deleting recipients in the current connection state is invalid.
The
SMFIF_DELRCPT
is not set when the
smfi_register()
routine is called.
smfi_delrcpt
returns
MI_SUCCESS
on success.
AUTHOR
smfi_dlercpt()
was developed by the Sendmail Inc.