HP-UX Reference (11i v3 07/02) - 3 Library Functions N-Z (vol 7)

smﬁ_addrcpt(3N) smﬁ_addrcpt(3N)

NAME

smﬁ_addrcpt() - adds a recipient for the current sendmail message

SYNOPSIS

#include <libmilter/mfapi.h>

int smfi_addrcpt(

SMFICTX *

ctx,

char *

rcpt

);

PARAMETERS

ctx Speciﬁes the opaque context structure.

rcpt Speciﬁes 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 ﬁlter that calls the smfi_addrcpt()

function must set the SMFIF_ADDRCPT ﬂag 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:

• The rcpt value is NULL.

• Adding recipients in the current connection state is invalid.

• Network error occurs.

• The

SMFIF_ADDRCPT ﬂag is not set when the

smfi_register() routine is called.

AUTHOR

smfi_addrcpt() was developed by the Sendmail Inc.