1<HTML>
2<HEAD><TITLE>smfi_addrcpt_par</TITLE></HEAD>
3<BODY>
4<!--
5$Id: smfi_addrcpt_par.html,v 1.5 2013-11-22 20:51:39 ca Exp $
6-->
7<H1>smfi_addrcpt_par</H1>
8
9<TABLE border="0" cellspacing=4 cellpadding=4>
10<!---------- Synopsis ----------->
11<TR><TH valign="top" align=left width=100>SYNOPSIS</TH><TD>
12<PRE>
13#include &lt;libmilter/mfapi.h&gt;
14int smfi_addrcpt_par(
15	SMFICTX *ctx,
16	char *rcpt,
17	char *args
18);
19</PRE>
20Add a recipient for the current message including ESMTP arguments.
21</TD></TR>
22
23<!----------- Description ---------->
24<TR><TH valign="top" align=left>DESCRIPTION</TH><TD>
25<TABLE border="1" cellspacing=1 cellpadding=4>
26<TR align="left" valign=top>
27<TH width="80">Called When</TH>
28<TD>Called only from <A href="xxfi_eom.html">xxfi_eom</A>.</TD>
29</TR>
30<TR align="left" valign=top>
31<TH width="80">Effects</TH>
32<TD>Add a recipient to the message envelope.</TD>
33</TR>
34</TABLE>
35
36<!----------- Arguments ---------->
37<TR><TH valign="top" align=left>ARGUMENTS</TH><TD>
38    <TABLE border="1" cellspacing=0>
39    <TR bgcolor="#dddddd"><TH>Argument</TH><TH>Description</TH></TR>
40    <TR valign="top"><TD>ctx</TD>
41	<TD>Opaque context structure.
42	</TD></TR>
43    <TR valign="top"><TD>rcpt</TD>
44	<TD>The new recipient's address.
45	</TD></TR>
46    <TR valign="top"><TD>args</TD>
47	<TD>The new recipient's ESMTP parameters.
48	</TD></TR>
49    </TABLE>
50</TD></TR>
51
52<!----------- Return values ---------->
53<TR>
54<TH valign="top" align=left>RETURN VALUES</TH>
55
56<TD>smfi_addrcpt will fail and return MI_FAILURE if:
57<UL><LI>rcpt is NULL.
58    <LI>Adding recipients in the current connection state is invalid.
59    <LI>A network error occurs.
60    <LI>SMFIF_ADDRCPT_PAR was not set when
61	<A href="smfi_register.html">smfi_register</A> was called.
62</UL>
63Otherwise, it will return MI_SUCCESS.
64</TD>
65</TR>
66
67<!----------- Notes ---------->
68<TR align="left" valign=top>
69<TH>NOTES</TH>
70<TD>
71A filter which calls smfi_addrcpt must have set the SMFIF_ADDRCPT_PAR flag
72in the smfiDesc_str passed to
73<A href="smfi_register.html">smfi_register</A>.
74</TD>
75</TR>
76
77</TABLE>
78
79<HR size="1">
80<FONT size="-1">
81Copyright (c) 2006 Proofpoint, Inc. and its suppliers.
82All rights reserved.
83<BR>
84By using this file, you agree to the terms and conditions set
85forth in the LICENSE.
86</FONT>
87</BODY>
88</HTML>
89