int smfi_addrcpt( SMFICTX *ctx, char *rcpt );
Add a recipient for the current message.
|Called When||Called only from xxfi_eom.|
|Effects||Add a recipient to the message envelope.|
|ctx||Opaque context structure.|
|rcpt||The new recipient's address.|
smfi_addrcpt will fail and return MI_FAILURE if:
- rcpt is NULL.
- Adding recipients in the current connection state is invalid.
- A network error occurs.
- SMFIF_ADDRCPT was not set when smfi_register was called.
Otherwise, it will return MI_SUCCESS.
A filter which calls smfi_addrcpt must have set the SMFIF_ADDRCPT flag in the smfiDesc_str passed to smfi_register.