2 <HEAD><TITLE>smfi_chgfrom</TITLE></HEAD>
5 $Id: smfi_chgfrom.html,v 1.3 2006/12/21 18:30:35 ca Exp $
9 <TABLE border="0" cellspacing=4 cellpadding=4>
10 <!---------- Synopsis ----------->
11 <TR><TH valign="top" align=left width=100>SYNOPSIS</TH><TD>
13 #include <libmilter/mfapi.h>
20 Change the envelope sender (MAIL From) of the current message.
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>
30 <TR align="left" valign=top>
31 <TH width="80">Effects</TH>
32 <TD>Change the envelope sender (MAIL From) of the current message.</TD>
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.
43 <TR valign="top"><TD>mail</TD>
44 <TD>The new sender address.
46 <TR valign="top"><TD>args</TD>
52 <!----------- Return values ---------->
54 <TH valign="top" align=left>RETURN VALUES</TH>
56 <TD>smfi_chgfrom will fail and return MI_FAILURE if:
58 <LI>Changing the sender in the current connection state is invalid.
59 <LI>A network error occurs.
60 <LI>SMFIF_CHGFROM was not set when <A href="smfi_register.html">smfi_register</A> was called.
62 Otherwise, it will return MI_SUCCESS.
66 <!----------- Notes ---------->
67 <TR align="left" valign=top>
70 A filter which calls smfi_chgfrom must have set the SMFIF_CHGFROM flag
71 in the smfiDesc_str passed to
72 <A href="smfi_register.html">smfi_register</A>.
74 Even though all ESMTP arguments could be set via this call,
75 it does not make sense to do so for many of them,
77 Setting those may cause problems, proper care must be taken.
78 Moreover, there is no feedback from the MTA to the milter
79 whether the call was successful.
87 Copyright (c) 2006 Sendmail, Inc. and its suppliers.
90 By using this file, you agree to the terms and conditions set