1168515Sgshapiro<HTML>
2168515Sgshapiro<HEAD><TITLE>smfi_setpriv</TITLE></HEAD>
3168515Sgshapiro<BODY>
4132943Sgshapiro<!--
5266692Sgshapiro$Id: smfi_setpriv.html,v 1.12 2013-11-22 20:51:39 ca Exp $
6132943Sgshapiro-->
7168515Sgshapiro<H1>smfi_setpriv</H1>
890792Sgshapiro
9168515Sgshapiro<TABLE border="0" cellspacing=4 cellpadding=4>
1090792Sgshapiro<!---------- Synopsis ----------->
11168515Sgshapiro<TR><TH valign="top" align=left width=100>SYNOPSIS</TH><TD>
12168515Sgshapiro<PRE>
1390792Sgshapiro#include &lt;libmilter/mfapi.h&gt;
1490792Sgshapiroint smfi_setpriv(
1590792Sgshapiro	SMFICTX *ctx,
1690792Sgshapiro	void *privatedata
1790792Sgshapiro);
18168515Sgshapiro</PRE>
1990792SgshapiroSet the private data pointer for this connection.
20168515Sgshapiro</TD></TR>
2190792Sgshapiro
2290792Sgshapiro<!----------- Description ---------->
23168515Sgshapiro<TR><TH valign="top" align=left>DESCRIPTION</TH><TD>
24168515Sgshapiro<TABLE border="1" cellspacing=1 cellpadding=4>
25168515Sgshapiro<TR align="left" valign=top>
26168515Sgshapiro<TH width="80">Called When</TH>
27168515Sgshapiro<TD>smfi_setpriv may be called in any of the xxfi_* callbacks.</TD>
28168515Sgshapiro</TR>
29168515Sgshapiro<TR align="left" valign=top>
30168515Sgshapiro<TH width="80">Effects</TH>
31168515Sgshapiro<TD>Sets the private data pointer for the context ctx.</TD>
32168515Sgshapiro</TR>
33168515Sgshapiro</TABLE>
3490792Sgshapiro
3590792Sgshapiro<!----------- Arguments ---------->
36168515Sgshapiro<TR><TH valign="top" align=left>ARGUMENTS</TH><TD>
37168515Sgshapiro    <TABLE border="1" cellspacing=0>
38168515Sgshapiro    <TR bgcolor="#dddddd"><TH>Argument</TH><TH>Description</TH></TR>
39168515Sgshapiro    <TR valign="top"><TD>ctx</TD>
40168515Sgshapiro	<TD>Opaque context structure.
41168515Sgshapiro	</TD></TR>
42168515Sgshapiro    <TR valign="top"><TD>privatedata</TD>
43168515Sgshapiro	<TD>Pointer to private data.  This value will be returned by subsequent calls to <A href="smfi_getpriv.html">smfi_getpriv</A> using ctx.
44168515Sgshapiro	</TD></TR>
45168515Sgshapiro    </TABLE>
46168515Sgshapiro</TD></TR>
4790792Sgshapiro
4890792Sgshapiro<!----------- Return values ---------->
49168515Sgshapiro<TR>
50168515Sgshapiro<TH valign="top" align=left>RETURN VALUES</TH> 
5190792Sgshapiro
52168515Sgshapiro<TD>smfi_setpriv returns MI_FAILURE if ctx is an invalid context.
53168515SgshapiroOtherwise, it returns MI_SUCCESS.</TD>
54168515Sgshapiro</TR>
5590792Sgshapiro
56168515Sgshapiro<TR>
57168515Sgshapiro<TH valign="top" align=left>NOTES</TH> 
5890792Sgshapiro
59168515Sgshapiro<TD>There is only one private data pointer per connection; multiple
6090792Sgshapirocalls to smfi_setpriv with different values will cause previous values
6190792Sgshapiroto be lost.
6290792Sgshapiro<P>
6390792SgshapiroBefore a filter terminates it should release the private data
6490792Sgshapiroand set the pointer to NULL.
65168515Sgshapiro</TD>
6690792Sgshapiro
67168515Sgshapiro</TR>
6890792Sgshapiro
69168515Sgshapiro</TABLE>
7090792Sgshapiro
71168515Sgshapiro<HR size="1">
72168515Sgshapiro<FONT size="-1">
73261363SgshapiroCopyright (c) 2000-2001, 2003 Proofpoint, Inc. and its suppliers.
7490792SgshapiroAll rights reserved.
75168515Sgshapiro<BR>
7690792SgshapiroBy using this file, you agree to the terms and conditions set
77112810Sgshapiroforth in the LICENSE.
78168515Sgshapiro</FONT>
79168515Sgshapiro</BODY>
80168515Sgshapiro</HTML>
81