smfi_addrcpt.3n (2010 09)

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.

PAGE 1
smfi_addrcpt(3N) smfi_addrcpt(3N) NAME smfi_addrcpt() - adds a recipient for the current sendmail message SYNOPSIS #include int smfi_addrcpt( SMFICTX *ctx , char *rcpt ); PARAMETERS ctx Specifies the opaque context structure. rcpt Specifies 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.
PAGE 2
(Notes) A (Notes) sA 2 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010