2 <head><title>smfi_delrcpt
</title></head>
5 $Id: smfi_delrcpt.html,v 1.9 2003/10/27 15:51:12 ca Exp $
9 <table border=
"0" cellspacing=
4 cellpadding=
4>
10 <!---------- Synopsis ----------->
11 <tr><th valign=
"top" align=left width=
150>SYNOPSIS
</th><td>
13 #include
<libmilter/mfapi.h
>
19 Remove a recipient from the current message's envelope.
22 <!----------- Description ---------->
23 <tr><th valign=
"top" align=left
>DESCRIPTION
</th><td>
24 <table border=
"1" cellspacing=
1 cellpadding=
4>
25 <tr align=
"left" valign=top
>
26 <th width=
"80">Called When
</th>
27 <td>Called only from
<a href=
"xxfi_eom.html">xxfi_eom
</a>.
</td>
29 <tr align=
"left" valign=top
>
30 <th width=
"80">Effects
</th>
31 <td>smfi_delrcpt removes the named recipient from the current message's envelope.
</td>
35 <!----------- Arguments ---------->
36 <tr><th valign=
"top" align=left
>ARGUMENTS
</th><td>
37 <table border=
"1" cellspacing=
0>
38 <tr bgcolor=
"#dddddd"><th>Argument
</th><th>Description
</th></tr>
39 <tr valign=
"top"><td>ctx
</td>
40 <td>Opaque context structure.
42 <tr valign=
"top"><td>rcpt
</td>
43 <td>The recipient address to be removed, a non-NULL, null-terminated string.
48 <!----------- Return values ---------->
50 <th valign=
"top" align=left
>RETURN VALUES
</th>
52 <td>smfi_delrcpt will fail and return MI_FAILURE if:
55 <li>Deleting recipients in the current connection state is invalid.
56 <li>A network error occurs.
57 <li>SMFIF_DELRCPT was not set when
<a href=
"smfi_register.html">smfi_register
</a> was called.
59 Otherwise, it will return MI_SUCCESS
63 <!----------- Notes ---------->
64 <tr align=
"left" valign=top
>
67 The addresses to be removed must match exactly. For example, an address and its expanded form do not match.
75 Copyright (c)
2000,
2003 Sendmail, Inc. and its suppliers.
78 By using this file, you agree to the terms and conditions set