smfi_addrcpt_par Function
Purpose
The smfi_addrcpt_par function adds a recipient for the current message including extended simple mail transfer protocol (ESMTP) arguments.
Syntax
#include <libmilter/mfapi.h>
int smfi_addrcpt_par(
SMFICTX *ctx,
char *rcpt,
char *args
);Description
The smfi_addrcpt_par function is called from the xxfi_eom function, to add a recipient to the message envelope.
Arguments
| Item | Description |
|---|---|
| ctx | The opaque context structure is maintained in the libmilter parameter. |
| rcpt | The new recipients address. |
| args | The new recipients ESMTP parameters. |
Return values
The smfi_addrcpt function
returns the MI_FAILURE value in the following cases. Otherwise,
the function returns MI_SUCCESS.
- The rcpt argument is NULL.
- Adding recipients in the current connection state is invalid.
- A network error occurs.
- The SMFIF_ADDRCPT_PAR flag was not set when smfi_register function was called.