int smfi_delrcpt( SMFICTX *ctx; char *rcpt; );
Remove a recipient from the current message's envelope.
|Called When||Called only from xxfi_eom.|
|Effects||smfi_delrcpt removes the named recipient from the current message's envelope.|
|ctx||Opaque context structure.|
|rcpt||The recipient address to be removed, a non-NULL, null-terminated string.|
smfi_delrcpt will fail and return MI_FAILURE if:
- rcpt is NULL.
- Deleting recipients in the current connection state is invalid.
- A network error occurs.
- SMFIF_DELRCPT was not set when smfi_register was called.
Otherwise, it will return MI_SUCCESS
The addresses to be removed must match exactly. For example, an address and its expanded form do not match.