1272343Sngie<HTML> 2272343Sngie<HEAD><TITLE>smfi_addrcpt_par</TITLE></HEAD> 3272343Sngie<BODY> 4272343Sngie<!-- 5272343Sngie$Id: smfi_addrcpt_par.html,v 1.5 2013-11-22 20:51:39 ca Exp $ 6272343Sngie--> 7272343Sngie<H1>smfi_addrcpt_par</H1> 8272343Sngie 9272343Sngie<TABLE border="0" cellspacing=4 cellpadding=4> 10272343Sngie<!---------- Synopsis -----------> 11272343Sngie<TR><TH valign="top" align=left width=100>SYNOPSIS</TH><TD> 12272343Sngie<PRE> 13272343Sngie#include <libmilter/mfapi.h> 14272343Sngieint smfi_addrcpt_par( 15272343Sngie SMFICTX *ctx, 16272343Sngie char *rcpt, 17272343Sngie char *args 18272343Sngie); 19272343Sngie</PRE> 20272343SngieAdd a recipient for the current message including ESMTP arguments. 21272343Sngie</TD></TR> 22272343Sngie 23272343Sngie<!----------- Description ----------> 24272343Sngie<TR><TH valign="top" align=left>DESCRIPTION</TH><TD> 25272343Sngie<TABLE border="1" cellspacing=1 cellpadding=4> 26272343Sngie<TR align="left" valign=top> 27272343Sngie<TH width="80">Called When</TH> 28272343Sngie<TD>Called only from <A href="xxfi_eom.html">xxfi_eom</A>.</TD> 29272343Sngie</TR> 30272343Sngie<TR align="left" valign=top> 31272343Sngie<TH width="80">Effects</TH> 32272343Sngie<TD>Add a recipient to the message envelope.</TD> 33272343Sngie</TR> 34272343Sngie</TABLE> 35272343Sngie 36272343Sngie<!----------- Arguments ----------> 37272343Sngie<TR><TH valign="top" align=left>ARGUMENTS</TH><TD> 38272343Sngie <TABLE border="1" cellspacing=0> 39272343Sngie <TR bgcolor="#dddddd"><TH>Argument</TH><TH>Description</TH></TR> 40272343Sngie <TR valign="top"><TD>ctx</TD> 41272343Sngie <TD>Opaque context structure. 42272343Sngie </TD></TR> 43272343Sngie <TR valign="top"><TD>rcpt</TD> 44272343Sngie <TD>The new recipient's address. 45272343Sngie </TD></TR> 46272343Sngie <TR valign="top"><TD>args</TD> 47272343Sngie <TD>The new recipient's ESMTP parameters. 48272343Sngie </TD></TR> 49272343Sngie </TABLE> 50272343Sngie</TD></TR> 51272343Sngie 52272343Sngie<!----------- Return values ----------> 53272343Sngie<TR> 54272343Sngie<TH valign="top" align=left>RETURN VALUES</TH> 55272343Sngie 56272343Sngie<TD>smfi_addrcpt will fail and return MI_FAILURE if: 57272343Sngie<UL><LI>rcpt is NULL. 58272343Sngie <LI>Adding recipients in the current connection state is invalid. 59272343Sngie <LI>A network error occurs. 60272343Sngie <LI>SMFIF_ADDRCPT_PAR was not set when 61272343Sngie <A href="smfi_register.html">smfi_register</A> was called. 62272343Sngie</UL> 63272343SngieOtherwise, it will return MI_SUCCESS. 64272343Sngie</TD> 65272343Sngie</TR> 66272343Sngie 67272343Sngie<!----------- Notes ----------> 68272343Sngie<TR align="left" valign=top> 69272343Sngie<TH>NOTES</TH> 70272343Sngie<TD> 71272343SngieA filter which calls smfi_addrcpt must have set the SMFIF_ADDRCPT_PAR flag 72272343Sngiein the smfiDesc_str passed to 73272343Sngie<A href="smfi_register.html">smfi_register</A>. 74272343Sngie</TD> 75272343Sngie</TR> 76272343Sngie 77272343Sngie</TABLE> 78272343Sngie 79272343Sngie<HR size="1"> 80272343Sngie<FONT size="-1"> 81272343SngieCopyright (c) 2006 Proofpoint, Inc. and its suppliers. 82272343SngieAll rights reserved. 83272343Sngie<BR> 84272343SngieBy using this file, you agree to the terms and conditions set 85272343Sngieforth in the LICENSE. 86272343Sngie</FONT> 87272343Sngie</BODY> 88272343Sngie</HTML> 89272343Sngie