smfi_addrcpt.html revision 90792 
150397Sobrien<html>
250397Sobrien<head><title>smfi_addrcpt</title></head>
350397Sobrien<body>
450397Sobrien<h1>smfi_addrcpt</h1>
550397Sobrien
650397Sobrien<table border="0" cellspacing=4 cellpadding=4>
750397Sobrien<!---------- Synopsis ----------->
850397Sobrien<tr><th valign="top" align=left width=150>SYNOPSIS</th><td>
950397Sobrien<pre>
1050397Sobrien#include &lt;libmilter/mfapi.h&gt;
1150397Sobrienint smfi_addrcpt(
1250397Sobrien	SMFICTX *ctx,
1390075Sobrien	char *rcpt
1450397Sobrien);
1550397Sobrien</pre>
1650397SobrienAdd a recipient for the current message.
1750397Sobrien</td></tr>
1850397Sobrien
1950397Sobrien<!----------- Description ---------->
2050397Sobrien<tr><th valign="top" align=left>DESCRIPTION</th><td>
2150397Sobrien<table border="1" cellspacing=1 cellpadding=4>
2250397Sobrien<tr align="left" valign=top>
2350397Sobrien<th width="80">Called When</th>
2450397Sobrien<td>Called only from <a href="xxfi_eom.html">xxfi_eom</a>.</td>
2550397Sobrien</tr>
2650397Sobrien<tr align="left" valign=top>
2750397Sobrien<th width="80">Effects</th>
2850397Sobrien<td>Add a recipient to the message envelope.</td>
2950397Sobrien</tr>
3050397Sobrien</table>
3150397Sobrien
3250397Sobrien<!----------- Arguments ---------->
3350397Sobrien<tr><th valign="top" align=left>ARGUMENTS</th><td>
3450397Sobrien    <table border="1" cellspacing=0>
3550397Sobrien    <tr bgcolor="#dddddd"><th>Argument</th><th>Description</th></tr>
3650397Sobrien    <tr valign="top"><td>ctx</td>
3750397Sobrien	<td>Opaque context structure.
3850397Sobrien	</td></tr>
3950397Sobrien    <tr valign="top"><td>rcpt</td>
4050397Sobrien	<td>The new recipient's address.
4150397Sobrien	</td></tr>
4250397Sobrien    </table>
4350397Sobrien</td></tr>
4450397Sobrien
4550397Sobrien<!----------- Return values ---------->
4650397Sobrien<tr>
4750397Sobrien<th valign="top" align=left>RETURN VALUES</th> 
4850397Sobrien
4950397Sobrien<td>smfi_addrcpt will fail and return MI_FAILURE if:
5050397Sobrien<ul><li>rcpt is NULL.
5150397Sobrien    <li>Adding headers in the current connection state is invalid.
5250397Sobrien    <li>A network error occurs.
5350397Sobrien    <li>SMFIF_ADDRCPT was not set when <a href="smfi_register.html">smfi_register</a> was called.
5450397Sobrien</ul>
5550397SobrienOtherwise, it will return MI_SUCCESS.
56169689Skan</td>
57169689Skan</tr>
58169689Skan
5950397Sobrien<!----------- Notes ---------->
6050397Sobrien<tr align="left" valign=top>
6150397Sobrien<th>NOTES</th> 
6250397Sobrien<td>
6350397SobrienA filter which calls smfi_addrcpt must have set the SMFIF_ADDRCPT flag
64169689Skanin the smfiDesc_str passed to 
65169689Skan<a href="smfi_register.html">smfi_register</a>.
66169689Skan</td>
67169689Skan</tr>
6850397Sobrien
69169689Skan</table>
7050397Sobrien
7150397Sobrien<hr size="1">
7250397Sobrien<font size="-1">
7350397SobrienCopyright (c) 2000 Sendmail, Inc. and its suppliers.
7450397SobrienAll rights reserved.
7550397Sobrien<br>
7650397SobrienBy using this file, you agree to the terms and conditions set
7750397Sobrienforth in the <a href="LICENSE.txt">LICENSE</a>.
7850397Sobrien</font>
7950397Sobrien</body>
8050397Sobrien</html>
8150397Sobrien