<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<title>meanwhile: mw_session.h Source File</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.5.4 -->
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="classes.html"><span>Data Structures</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
</ul>
</div>
<h1>mw_session.h</h1><a href="mw__session_8h.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001
<a name="l00002"></a>00002 <span class="comment">/*</span>
<a name="l00003"></a>00003 <span class="comment"> Meanwhile - Unofficial Lotus Sametime Community Client Library</span>
<a name="l00004"></a>00004 <span class="comment"> Copyright (C) 2004 Christopher (siege) O'Brien</span>
<a name="l00005"></a>00005 <span class="comment"> </span>
<a name="l00006"></a>00006 <span class="comment"> This library is free software; you can redistribute it and/or</span>
<a name="l00007"></a>00007 <span class="comment"> modify it under the terms of the GNU Library General Public</span>
<a name="l00008"></a>00008 <span class="comment"> License as published by the Free Software Foundation; either</span>
<a name="l00009"></a>00009 <span class="comment"> version 2 of the License, or (at your option) any later version.</span>
<a name="l00010"></a>00010 <span class="comment"> </span>
<a name="l00011"></a>00011 <span class="comment"> This library is distributed in the hope that it will be useful,</span>
<a name="l00012"></a>00012 <span class="comment"> but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="l00013"></a>00013 <span class="comment"> MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU</span>
<a name="l00014"></a>00014 <span class="comment"> Library General Public License for more details.</span>
<a name="l00015"></a>00015 <span class="comment"> </span>
<a name="l00016"></a>00016 <span class="comment"> You should have received a copy of the GNU Library General Public</span>
<a name="l00017"></a>00017 <span class="comment"> License along with this library; if not, write to the Free</span>
<a name="l00018"></a>00018 <span class="comment"> Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA</span>
<a name="l00019"></a>00019 <span class="comment">*/</span>
<a name="l00020"></a>00020
<a name="l00021"></a>00021 <span class="preprocessor">#ifndef _MW_SESSION_H</span>
<a name="l00022"></a>00022 <span class="preprocessor"></span><span class="preprocessor">#define _MW_SESSION_H</span>
<a name="l00023"></a>00023 <span class="preprocessor"></span>
<a name="l00024"></a>00024
<a name="l00047"></a>00047 <span class="preprocessor">#include "<a class="code" href="mw__common_8h.html" title="Common data types and functions for handling those types.">mw_common.h</a>"</span>
<a name="l00048"></a>00048
<a name="l00049"></a>00049
<a name="l00050"></a>00050 <span class="preprocessor">#ifdef __cplusplus</span>
<a name="l00051"></a>00051 <span class="preprocessor"></span><span class="keyword">extern</span> <span class="stringliteral">"C"</span> {
<a name="l00052"></a>00052 <span class="preprocessor">#endif</span>
<a name="l00053"></a>00053 <span class="preprocessor"></span>
<a name="l00054"></a>00054
<a name="l00055"></a>00055 <span class="keyword">struct </span><a class="code" href="structmwChannelSet.html" title="Collection of channels.">mwChannelSet</a>;
<a name="l00056"></a>00056 <span class="keyword">struct </span><a class="code" href="structmwCipher.html" title="A cipher.">mwCipher</a>;
<a name="l00057"></a>00057 <span class="keyword">struct </span><a class="code" href="structmwMessage.html">mwMessage</a>;
<a name="l00058"></a>00058 <span class="keyword">struct </span><a class="code" href="structmwService.html" title="A service is the recipient of sendOnCnl messages sent over channels marked with the...">mwService</a>;
<a name="l00059"></a>00059
<a name="l00060"></a>00060
<a name="l00062"></a><a class="code" href="mw__session_8h.html#9d3b3989818cc643dd2f39e25d74ab28">00062</a> <span class="preprocessor">#define MW_PROTOCOL_VERSION_MAJOR 0x001e</span>
<a name="l00063"></a>00063 <span class="preprocessor"></span>
<a name="l00064"></a>00064
<a name="l00066"></a><a class="code" href="mw__session_8h.html#913fb2fb3be37e4248d5b708b6c71e51">00066</a> <span class="preprocessor">#define MW_PROTOCOL_VERSION_MINOR 0x001d</span>
<a name="l00067"></a>00067 <span class="preprocessor"></span>
<a name="l00068"></a>00068
<a name="l00073"></a>00073
<a name="l00075"></a><a class="code" href="mw__session_8h.html#6a5be138257a3274423d3637dd4f7162">00075</a> <span class="preprocessor">#define mwSession_AUTH_USER_ID "session.auth.user"</span>
<a name="l00076"></a>00076 <span class="preprocessor"></span>
<a name="l00078"></a><a class="code" href="mw__session_8h.html#f0a7031c22a277fd04e19717b1cefa45">00078</a> <span class="preprocessor">#define mwSession_AUTH_PASSWORD "session.auth.password"</span>
<a name="l00079"></a>00079 <span class="preprocessor"></span>
<a name="l00081"></a><a class="code" href="mw__session_8h.html#795bdeae05d31ee88b013404b8a5caaf">00081</a> <span class="preprocessor">#define mwSession_AUTH_TOKEN "session.auth.token"</span>
<a name="l00082"></a>00082 <span class="preprocessor"></span>
<a name="l00084"></a><a class="code" href="mw__session_8h.html#1e671d0043d238356ea33e133ff9fd93">00084</a> <span class="preprocessor">#define mwSession_CLIENT_HOST "client.host"</span>
<a name="l00085"></a>00085 <span class="preprocessor"></span>
<a name="l00087"></a><a class="code" href="mw__session_8h.html#68baacbfa6cd815b600e84f32a0b2157">00087</a> <span class="preprocessor">#define mwSession_CLIENT_IP "client.ip"</span>
<a name="l00088"></a>00088 <span class="preprocessor"></span>
<a name="l00090"></a><a class="code" href="mw__session_8h.html#52bbb3a6fd21e59b8e9e467e95b142a9">00090</a> <span class="preprocessor">#define mwSession_CLIENT_VER_MAJOR "client.version.major"</span>
<a name="l00091"></a>00091 <span class="preprocessor"></span>
<a name="l00093"></a><a class="code" href="mw__session_8h.html#a3b7220625ca769b77af646e589bc2f3">00093</a> <span class="preprocessor">#define mwSession_CLIENT_VER_MINOR "client.version.minor"</span>
<a name="l00094"></a>00094 <span class="preprocessor"></span>
<a name="l00096"></a><a class="code" href="mw__session_8h.html#b6fe3a356e3c665f0751b670e96d1a58">00096</a> <span class="preprocessor">#define mwSession_CLIENT_TYPE_ID "client.id"</span>
<a name="l00097"></a>00097 <span class="preprocessor"></span>
<a name="l00099"></a><a class="code" href="mw__session_8h.html#6bac49bf2171ad349c3f8c4dac16c1c8">00099</a> <span class="preprocessor">#define mwSession_SERVER_VER_MAJOR "server.version.major"</span>
<a name="l00100"></a>00100 <span class="preprocessor"></span>
<a name="l00102"></a><a class="code" href="mw__session_8h.html#87f478d902728b24efa6b29300d3f80b">00102</a> <span class="preprocessor">#define mwSession_SERVER_VER_MINOR "server.version.minor"</span>
<a name="l00103"></a>00103 <span class="preprocessor"></span>
<a name="l00107"></a><a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8f">00107</a> <span class="keyword">enum</span> <a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8f">mwSessionState</a> {
<a name="l00108"></a><a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8f9830cfccaba808c30bf7bc124878c121">00108</a> <a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8f9830cfccaba808c30bf7bc124878c121" title="session is starting">mwSession_STARTING</a>,
<a name="l00109"></a><a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8f2ac4bf847cbc46277a3c73839934243a">00109</a> <a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8f2ac4bf847cbc46277a3c73839934243a" title="session has sent handshake">mwSession_HANDSHAKE</a>,
<a name="l00110"></a><a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8f994478c24dcd42f57063fab313fdd8f0">00110</a> <a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8f994478c24dcd42f57063fab313fdd8f0" title="session has received handshake ack">mwSession_HANDSHAKE_ACK</a>,
<a name="l00111"></a><a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8fd13ae235c70756d58e86a5d3fa0a9fd7">00111</a> <a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8fd13ae235c70756d58e86a5d3fa0a9fd7" title="session has sent login">mwSession_LOGIN</a>,
<a name="l00112"></a><a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8f6fba5e714829218cff2bcf8990429c84">00112</a> <a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8f6fba5e714829218cff2bcf8990429c84" title="session has been redirected">mwSession_LOGIN_REDIR</a>,
<a name="l00113"></a><a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8f13304078f2f7c7899a3e6ff8b0d43e10">00113</a> <a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8f13304078f2f7c7899a3e6ff8b0d43e10" title="session has received login ack">mwSession_LOGIN_ACK</a>,
<a name="l00114"></a><a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8f6204d52622b541dd60cd40e004d2118d">00114</a> <a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8f6204d52622b541dd60cd40e004d2118d" title="session is active">mwSession_STARTED</a>,
<a name="l00115"></a><a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8fb710bf16db3e1f29f773c6bf70ee9ee9">00115</a> <a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8fb710bf16db3e1f29f773c6bf70ee9ee9" title="session is shutting down">mwSession_STOPPING</a>,
<a name="l00116"></a><a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8f69035e27489f79b82d9ef3c7b9514706">00116</a> <a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8f69035e27489f79b82d9ef3c7b9514706" title="session is stopped">mwSession_STOPPED</a>,
<a name="l00117"></a><a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8fbd45e4568ae4b047f7c90b1aeb57c580">00117</a> <a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8fbd45e4568ae4b047f7c90b1aeb57c580" title="indicates an error determining state">mwSession_UNKNOWN</a>,
<a name="l00118"></a><a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8f44286972a65354abfc208e0a5c922ccb">00118</a> <a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8f44286972a65354abfc208e0a5c922ccb" title="session has sent a login continue">mwSession_LOGIN_CONT</a>,
<a name="l00119"></a>00119 };
<a name="l00120"></a>00120
<a name="l00121"></a>00121
<a name="l00122"></a><a class="code" href="mw__session_8h.html#4de18b78247d38abdbf8e6b17911af6a">00122</a> <span class="preprocessor">#define mwSession_isState(session, state) \</span>
<a name="l00123"></a>00123 <span class="preprocessor"> (mwSession_getState((session)) == (state))</span>
<a name="l00124"></a>00124 <span class="preprocessor"></span>
<a name="l00125"></a><a class="code" href="mw__session_8h.html#0cd5392222008433c62e3f49fcc002cb">00125</a> <span class="preprocessor">#define mwSession_isStarting(s) \</span>
<a name="l00126"></a>00126 <span class="preprocessor"> (mwSession_isState((s), mwSession_STARTING) || \</span>
<a name="l00127"></a>00127 <span class="preprocessor"> mwSession_isState((s), mwSession_HANDSHAKE) || \</span>
<a name="l00128"></a>00128 <span class="preprocessor"> mwSession_isState((s), mwSession_HANDSHAKE_ACK) || \</span>
<a name="l00129"></a>00129 <span class="preprocessor"> mwSession_isState((s), mwSession_LOGIN) || \</span>
<a name="l00130"></a>00130 <span class="preprocessor"> mwSession_isState((s), mwSession_LOGIN_ACK) || \</span>
<a name="l00131"></a>00131 <span class="preprocessor"> mwSession_isState((s), mwSession_LOGIN_REDIR) || \</span>
<a name="l00132"></a>00132 <span class="preprocessor"> mwSession_isState((s), mwSession_LOGIN_CONT))</span>
<a name="l00133"></a>00133 <span class="preprocessor"></span>
<a name="l00134"></a><a class="code" href="mw__session_8h.html#3315b63b3e5f89fffe09d0011e619abe">00134</a> <span class="preprocessor">#define mwSession_isStarted(s) \</span>
<a name="l00135"></a>00135 <span class="preprocessor"> (mwSession_isState((s), mwSession_STARTED))</span>
<a name="l00136"></a>00136 <span class="preprocessor"></span>
<a name="l00137"></a><a class="code" href="mw__session_8h.html#e1e43ebfa1b40404e9a81fb238bf4c3f">00137</a> <span class="preprocessor">#define mwSession_isStopping(s) \</span>
<a name="l00138"></a>00138 <span class="preprocessor"> (mwSession_isState((s), mwSession_STOPPING))</span>
<a name="l00139"></a>00139 <span class="preprocessor"></span>
<a name="l00140"></a><a class="code" href="mw__session_8h.html#6675346a430b5966fa3104cc7d84a9cf">00140</a> <span class="preprocessor">#define mwSession_isStopped(s) \</span>
<a name="l00141"></a>00141 <span class="preprocessor"> (mwSession_isState((s), mwSession_STOPPED))</span>
<a name="l00142"></a>00142 <span class="preprocessor"></span>
<a name="l00143"></a>00143
<a name="l00147"></a>00147 <span class="keyword">struct </span><a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a>;
<a name="l00148"></a>00148
<a name="l00149"></a>00149
<a name="l00154"></a><a class="code" href="structmwSessionHandler.html">00154</a> <span class="keyword">struct </span><a class="code" href="structmwSessionHandler.html" title="session handler.">mwSessionHandler</a> {
<a name="l00155"></a>00155
<a name="l00158"></a>00158 int (*<a class="code" href="structmwSessionHandler.html#1486698a54d398ebc8b249845e4d963d" title="write data to the server connection.">io_write</a>)(<span class="keyword">struct </span><a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *, <span class="keyword">const</span> guchar *buf, gsize len);
<a name="l00159"></a>00159
<a name="l00161"></a>00161 void (*<a class="code" href="structmwSessionHandler.html#9f1194a806f6fe0d72ff8548937069e8" title="close the server connection.">io_close</a>)(<span class="keyword">struct </span><a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *);
<a name="l00162"></a>00162
<a name="l00164"></a>00164 void (*<a class="code" href="structmwSessionHandler.html#7732ee46c3a75c078366f04b9e942884" title="triggered by mwSession_free.">clear</a>)(<span class="keyword">struct </span><a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *);
<a name="l00165"></a>00165
<a name="l00173"></a>00173 void (*<a class="code" href="structmwSessionHandler.html#855d0d5eaee87178480f84636cce3abb" title="Called when the session has changed status.">on_stateChange</a>)(<span class="keyword">struct </span><a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *s,
<a name="l00174"></a>00174 <span class="keyword">enum</span> <a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8f">mwSessionState</a> state, gpointer info);
<a name="l00175"></a>00175
<a name="l00180"></a>00180 void (*<a class="code" href="structmwSessionHandler.html#407f9f2eba98558659dc194af6863eb0" title="called when privacy information has been sent or received">on_setPrivacyInfo</a>)(<span class="keyword">struct </span><a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *);
<a name="l00181"></a>00181
<a name="l00185"></a>00185 void (*<a class="code" href="structmwSessionHandler.html#49a9eee40b0b0b006621d81a1171822b" title="called when user status has changed">on_setUserStatus</a>)(<span class="keyword">struct </span><a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *);
<a name="l00186"></a>00186
<a name="l00188"></a>00188 void (*<a class="code" href="structmwSessionHandler.html#b2f7b56b4c70bf854a60c996e858b585" title="called when an admin messages has been received">on_admin</a>)(<span class="keyword">struct </span><a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *, <span class="keyword">const</span> <span class="keywordtype">char</span> *text);
<a name="l00189"></a>00189
<a name="l00191"></a>00191 void (*<a class="code" href="structmwSessionHandler.html#e8024cba10f63fd882c96b161d5692ac" title="called when an announcement arrives">on_announce</a>)(<span class="keyword">struct </span><a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *, <span class="keyword">struct </span><a class="code" href="structmwLoginInfo.html">mwLoginInfo</a> *from,
<a name="l00192"></a>00192 gboolean may_reply, <span class="keyword">const</span> <span class="keywordtype">char</span> *text);
<a name="l00193"></a>00193
<a name="l00194"></a>00194 };
<a name="l00195"></a>00195
<a name="l00196"></a>00196
<a name="l00198"></a>00198 <span class="keyword">struct </span><a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *<a class="code" href="mw__session_8h.html#e0a8e4b2f0a24b6e6db29f5a57442369" title="allocate a new session">mwSession_new</a>(<span class="keyword">struct</span> <a class="code" href="structmwSessionHandler.html" title="session handler.">mwSessionHandler</a> *);
<a name="l00199"></a>00199
<a name="l00200"></a>00200
<a name="l00203"></a>00203 <span class="keywordtype">void</span> <a class="code" href="mw__session_8h.html#15f227dac0e09d26e5d51647741d02c1" title="stop, clear, free a session.">mwSession_free</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *);
<a name="l00204"></a>00204
<a name="l00205"></a>00205
<a name="l00207"></a>00207 <span class="keyword">struct </span><a class="code" href="structmwSessionHandler.html" title="session handler.">mwSessionHandler</a> *<a class="code" href="mw__session_8h.html#6ca89c231099ec608255f9153e48bd41" title="obtain a reference to the session&#39;s handler">mwSession_getHandler</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *);
<a name="l00208"></a>00208
<a name="l00209"></a>00209
<a name="l00212"></a>00212 <span class="keywordtype">void</span> <a class="code" href="mw__session_8h.html#1c3e5aac455c0594e21b02a379395513" title="instruct the session to begin.">mwSession_start</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *);
<a name="l00213"></a>00213
<a name="l00214"></a>00214
<a name="l00217"></a>00217 <span class="keywordtype">void</span> <a class="code" href="mw__session_8h.html#ca902e9266e244ff9ae2a325a7a655ba" title="instruct the session to shut down with the following reason code.">mwSession_stop</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *, guint32 reason);
<a name="l00218"></a>00218
<a name="l00219"></a>00219
<a name="l00222"></a>00222 <span class="keywordtype">void</span> <a class="code" href="mw__session_8h.html#69261eefd22f97f6fd453ca0507cff9e" title="Data is buffered, unpacked, and parsed into a message, then processed accordingly...">mwSession_recv</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *, <span class="keyword">const</span> guchar *, gsize);
<a name="l00223"></a>00223
<a name="l00224"></a>00224
<a name="l00229"></a>00229 <span class="keywordtype">int</span> <a class="code" href="mw__session_8h.html#547ba5e8411854dfdcc4fd1b992c7da8" title="primarily used by services to have messages serialized and sent">mwSession_send</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *s, <span class="keyword">struct</span> <a class="code" href="structmwMessage.html">mwMessage</a> *msg);
<a name="l00230"></a>00230
<a name="l00231"></a>00231
<a name="l00233"></a>00233 <span class="keywordtype">int</span> <a class="code" href="mw__session_8h.html#76937609f785aa1830fddd58c5995477" title="sends the keepalive byte">mwSession_sendKeepalive</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *s);
<a name="l00234"></a>00234
<a name="l00235"></a>00235
<a name="l00238"></a>00238 <span class="keywordtype">int</span> <a class="code" href="mw__session_8h.html#0d942b183a0657122fd511816cde0aae" title="respond to a login redirect message by forcing the login sequence to continue through...">mwSession_forceLogin</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *s);
<a name="l00239"></a>00239
<a name="l00240"></a>00240
<a name="l00251"></a>00251 <span class="keywordtype">int</span> <a class="code" href="mw__session_8h.html#b4bb651abfc49566be231bfa082f9d01" title="send an announcement to a list of users/groups.">mwSession_sendAnnounce</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *s, gboolean may_reply,
<a name="l00252"></a>00252 <span class="keyword">const</span> <span class="keywordtype">char</span> *text, <span class="keyword">const</span> GList *recipients);
<a name="l00253"></a>00253
<a name="l00254"></a>00254
<a name="l00257"></a>00257 <span class="keywordtype">int</span> <a class="code" href="mw__session_8h.html#f0073cb84869b5e61a2eae4eccf265d4" title="set the internal privacy information, and inform the server as necessary.">mwSession_setPrivacyInfo</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *, <span class="keyword">struct</span> <a class="code" href="structmwPrivacyInfo.html">mwPrivacyInfo</a> *);
<a name="l00258"></a>00258
<a name="l00259"></a>00259
<a name="l00261"></a>00261 <span class="keyword">struct </span><a class="code" href="structmwPrivacyInfo.html">mwPrivacyInfo</a> *<a class="code" href="mw__session_8h.html#f40d8491fa06d6386414f8bd54d33e04" title="direct reference to the session&#39;s internal privacy structure">mwSession_getPrivacyInfo</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *);
<a name="l00262"></a>00262
<a name="l00263"></a>00263
<a name="l00265"></a>00265 <span class="keyword">struct </span><a class="code" href="structmwLoginInfo.html">mwLoginInfo</a> *<a class="code" href="mw__session_8h.html#2c2c73c430879bc51bd53d5dea9ff87c" title="reference the login information for the session">mwSession_getLoginInfo</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *);
<a name="l00266"></a>00266
<a name="l00267"></a>00267
<a name="l00270"></a>00270 <span class="keywordtype">int</span> <a class="code" href="mw__session_8h.html#6fad26d4cfa3dd7bdc1b402ff2ec10d7" title="set the internal user status state, and inform the server as necessary.">mwSession_setUserStatus</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *, <span class="keyword">struct</span> <a class="code" href="structmwUserStatus.html">mwUserStatus</a> *);
<a name="l00271"></a>00271
<a name="l00272"></a>00272
<a name="l00273"></a>00273 <span class="keyword">struct </span><a class="code" href="structmwUserStatus.html">mwUserStatus</a> *<a class="code" href="mw__session_8h.html#394f76a8608dedd50c4984364649c150">mwSession_getUserStatus</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *);
<a name="l00274"></a>00274
<a name="l00275"></a>00275
<a name="l00277"></a>00277 <span class="keyword">enum</span> <a class="code" href="mw__session_8h.html#f27bba1d2fcb53358371c0eca6c57a8f">mwSessionState</a> <a class="code" href="mw__session_8h.html#c98375b3bdde1fcb6f7576376495ad09" title="current status of the session">mwSession_getState</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *);
<a name="l00278"></a>00278
<a name="l00279"></a>00279
<a name="l00292"></a>00292 gpointer <a class="code" href="mw__session_8h.html#4ccd4606756bf065c52ed31d59fb4482" title="additional status-specific information.">mwSession_getStateInfo</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *);
<a name="l00293"></a>00293
<a name="l00294"></a>00294
<a name="l00295"></a>00295 <span class="keyword">struct </span><a class="code" href="structmwChannelSet.html" title="Collection of channels.">mwChannelSet</a> *<a class="code" href="mw__session_8h.html#9b649dca88ecfe556931204f61cfc7f0">mwSession_getChannels</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *);
<a name="l00296"></a>00296
<a name="l00297"></a>00297
<a name="l00305"></a>00305 gboolean <a class="code" href="mw__session_8h.html#c6f9b04c3b494dde60ee7dd064370582" title="adds a service to the session.">mwSession_addService</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *, <span class="keyword">struct</span> <a class="code" href="structmwService.html" title="A service is the recipient of sendOnCnl messages sent over channels marked with the...">mwService</a> *);
<a name="l00306"></a>00306
<a name="l00307"></a>00307
<a name="l00309"></a>00309 <span class="keyword">struct </span><a class="code" href="structmwService.html" title="A service is the recipient of sendOnCnl messages sent over channels marked with the...">mwService</a> *<a class="code" href="mw__session_8h.html#9219b977141fa0211d0cce8848e4a11d" title="find a service by its type identifier">mwSession_getService</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *, guint32 <a class="code" href="structmwService.html#d2d3325c80ad007b9cf0e7ac8c7ec63f" title="the unique identifier by which this service is registered.">type</a>);
<a name="l00310"></a>00310
<a name="l00311"></a>00311
<a name="l00315"></a>00315 <span class="keyword">struct </span><a class="code" href="structmwService.html" title="A service is the recipient of sendOnCnl messages sent over channels marked with the...">mwService</a> *<a class="code" href="mw__session_8h.html#43e307ec9138cfe706ce91ab5978bb08" title="removes a service from the session.">mwSession_removeService</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *, guint32 <a class="code" href="structmwService.html#d2d3325c80ad007b9cf0e7ac8c7ec63f" title="the unique identifier by which this service is registered.">type</a>);
<a name="l00316"></a>00316
<a name="l00317"></a>00317
<a name="l00320"></a>00320 GList *<a class="code" href="mw__session_8h.html#88c6a4eb07a4ed80e561772645da6e6c" title="a GList of services in this session.">mwSession_getServices</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *);
<a name="l00321"></a>00321
<a name="l00322"></a>00322
<a name="l00335"></a>00335 <span class="keywordtype">void</span> <a class="code" href="mw__session_8h.html#7c2770250f36c6c2cc3b8a857a5e42db" title="instruct a STARTED session to check the server for the presense of a given service...">mwSession_senseService</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *s, guint32 <a class="code" href="structmwService.html#d2d3325c80ad007b9cf0e7ac8c7ec63f" title="the unique identifier by which this service is registered.">type</a>);
<a name="l00336"></a>00336
<a name="l00337"></a>00337
<a name="l00339"></a>00339 gboolean <a class="code" href="mw__session_8h.html#8f032bd5928aefde5e78976717d2e6fb" title="adds a cipher to the session.">mwSession_addCipher</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *, <span class="keyword">struct</span> <a class="code" href="structmwCipher.html" title="A cipher.">mwCipher</a> *);
<a name="l00340"></a>00340
<a name="l00341"></a>00341
<a name="l00343"></a>00343 <span class="keyword">struct </span><a class="code" href="structmwCipher.html" title="A cipher.">mwCipher</a> *<a class="code" href="mw__session_8h.html#4ba31ddd29d88229f2e8e61ff8728374" title="find a cipher by its type identifier">mwSession_getCipher</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *, guint16 <a class="code" href="structmwCipher.html#a65d8c035878ffd68aa21099a18eb959" title="mwCipher_getType">type</a>);
<a name="l00344"></a>00344
<a name="l00345"></a>00345
<a name="l00347"></a>00347 <span class="keyword">struct </span><a class="code" href="structmwCipher.html" title="A cipher.">mwCipher</a> *<a class="code" href="mw__session_8h.html#b5825818838148ea8beb0448639a40a0" title="remove a cipher from the session">mwSession_removeCipher</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *, guint16 <a class="code" href="structmwCipher.html#a65d8c035878ffd68aa21099a18eb959" title="mwCipher_getType">type</a>);
<a name="l00348"></a>00348
<a name="l00349"></a>00349
<a name="l00352"></a>00352 GList *<a class="code" href="mw__session_8h.html#214296ae70ec8a7e7aa8d5073209b925" title="a GList of ciphers in this session.">mwSession_getCiphers</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *);
<a name="l00353"></a>00353
<a name="l00354"></a>00354
<a name="l00358"></a>00358 <span class="keywordtype">void</span> <a class="code" href="mw__session_8h.html#d2b99bcf049f9906c7151b7626273b0d" title="associate a key:value pair with the session.">mwSession_setProperty</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *, <span class="keyword">const</span> <span class="keywordtype">char</span> *key,
<a name="l00359"></a>00359 gpointer val, GDestroyNotify <a class="code" href="structmwService.html#9b86cc0545150a4fde3ab3060e803e58" title="The service&#39;s cleanup handler.">clear</a>);
<a name="l00360"></a>00360
<a name="l00361"></a>00361
<a name="l00363"></a>00363 gpointer <a class="code" href="mw__session_8h.html#cc536511205affec12c734efd9735e91" title="obtain the value of a previously set property, or NULL">mwSession_getProperty</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *, <span class="keyword">const</span> <span class="keywordtype">char</span> *key);
<a name="l00364"></a>00364
<a name="l00365"></a>00365
<a name="l00368"></a>00368 <span class="keywordtype">void</span> <a class="code" href="mw__session_8h.html#cd2f1aab5eb04b29e73040069c04a976" title="remove a property, calling the optional GDestroyNotify function indicated in mwSession_setProperty...">mwSession_removeProperty</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *, <span class="keyword">const</span> <span class="keywordtype">char</span> *key);
<a name="l00369"></a>00369
<a name="l00370"></a>00370
<a name="l00379"></a>00379 <span class="keywordtype">void</span> <a class="code" href="mw__session_8h.html#d24576610f20159cf13c6104a1f5c615" title="associate arbitrary data with the session for use by the client code.">mwSession_setClientData</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *<a class="code" href="structmwService.html#0c2badd2256155b2bee149fa4b57b7d6" title="session this service is attached to.">session</a>,
<a name="l00380"></a>00380 gpointer data, GDestroyNotify <a class="code" href="structmwService.html#9b86cc0545150a4fde3ab3060e803e58" title="The service&#39;s cleanup handler.">clear</a>);
<a name="l00381"></a>00381
<a name="l00382"></a>00382
<a name="l00383"></a>00383 gpointer <a class="code" href="mw__session_8h.html#2061173e5b0b7199b7951920a475de22">mwSession_getClientData</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *<a class="code" href="structmwService.html#0c2badd2256155b2bee149fa4b57b7d6" title="session this service is attached to.">session</a>);
<a name="l00384"></a>00384
<a name="l00385"></a>00385
<a name="l00388"></a>00388 <span class="keywordtype">void</span> <a class="code" href="mw__session_8h.html#f5fe774ac33affc9c141c0b30c8c4a7a" title="remove client data, calling the optional GDestroyNotify function indicated in mwSession_setClientDat...">mwSession_removeClientData</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *<a class="code" href="structmwService.html#0c2badd2256155b2bee149fa4b57b7d6" title="session this service is attached to.">session</a>);
<a name="l00389"></a>00389
<a name="l00390"></a>00390
<a name="l00391"></a>00391 <span class="preprocessor">#ifdef __cplusplus</span>
<a name="l00392"></a>00392 <span class="preprocessor"></span>}
<a name="l00393"></a>00393 <span class="preprocessor">#endif</span>
<a name="l00394"></a>00394 <span class="preprocessor"></span>
<a name="l00395"></a>00395
<a name="l00396"></a>00396 <span class="preprocessor">#endif </span><span class="comment">/* _MW_SESSION_H */</span>
<a name="l00397"></a>00397
</pre></div><hr size="1"><address style="text-align: right;"><small>Generated on Wed Dec 19 09:10:33 2007 for meanwhile by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.4 </small></address>
</body>
</html>
distrib
>
Mandriva
>
2008.1
>
x86_64
>
media
>
main-release
>
by-pkgid
>
d4a6745d7fbd92dfb64dce5e91e08f80
>
files
>
98
