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 &lt;libmilter/mfapi.h&gt;
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