Sophie

Sophie

distrib > Mandriva > 2008.1 > x86_64 > media > main-release > by-pkgid > d4a6745d7fbd92dfb64dce5e91e08f80 > files > 112

lib64meanwhile1-doc-1.0.2-1mdv2008.1.x86_64.rpm

<!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_srvc_resolve.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&nbsp;Page</span></a></li>
    <li><a href="classes.html"><span>Data&nbsp;Structures</span></a></li>
    <li class="current"><a href="files.html"><span>Files</span></a></li>
    <li><a href="pages.html"><span>Related&nbsp;Pages</span></a></li>
  </ul>
</div>
<h1>mw_srvc_resolve.h</h1><a href="mw__srvc__resolve_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_SRVC_RESOLVE_H</span>
<a name="l00022"></a>00022 <span class="preprocessor"></span><span class="preprocessor">#define _MW_SRVC_RESOLVE_H</span>
<a name="l00023"></a>00023 <span class="preprocessor"></span>
<a name="l00024"></a>00024 
<a name="l00025"></a>00025 <span class="preprocessor">#include &lt;glib.h&gt;</span>
<a name="l00026"></a>00026 <span class="preprocessor">#include &lt;glib/glist.h&gt;</span>
<a name="l00027"></a>00027 
<a name="l00028"></a>00028 
<a name="l00029"></a>00029 <span class="preprocessor">#ifdef __cplusplus</span>
<a name="l00030"></a>00030 <span class="preprocessor"></span><span class="keyword">extern</span> <span class="stringliteral">"C"</span> {
<a name="l00031"></a>00031 <span class="preprocessor">#endif</span>
<a name="l00032"></a>00032 <span class="preprocessor"></span>
<a name="l00033"></a>00033 
<a name="l00035"></a><a class="code" href="mw__srvc__resolve_8h.html#86bbe7c161a9136f90b946fec18ce7d0">00035</a> <span class="preprocessor">#define mwService_RESOLVE  0x00000015</span>
<a name="l00036"></a>00036 <span class="preprocessor"></span>
<a name="l00037"></a>00037 
<a name="l00039"></a><a class="code" href="mw__srvc__resolve_8h.html#a95a23ed83ec736d0038afde41bd38a4">00039</a> <span class="preprocessor">#define SEARCH_ERROR  0x00</span>
<a name="l00040"></a>00040 <span class="preprocessor"></span>
<a name="l00041"></a>00041 
<a name="l00044"></a>00044 <span class="keyword">struct </span><a class="code" href="structmwServiceResolve.html" title="User lookup service.">mwServiceResolve</a>;
<a name="l00045"></a>00045 
<a name="l00046"></a>00046 
<a name="l00047"></a><a class="code" href="mw__srvc__resolve_8h.html#58431b16fa3147bd28b20f4d8e046bbb">00047</a> <span class="keyword">enum</span> <a class="code" href="mw__srvc__resolve_8h.html#58431b16fa3147bd28b20f4d8e046bbb">mwResolveFlag</a> {
<a name="l00049"></a><a class="code" href="mw__srvc__resolve_8h.html#58431b16fa3147bd28b20f4d8e046bbb115c168258bfa096e531592fbdf898b1">00049</a>   <a class="code" href="mw__srvc__resolve_8h.html#58431b16fa3147bd28b20f4d8e046bbb115c168258bfa096e531592fbdf898b1" title="return unique results or none at all">mwResolveFlag_UNIQUE</a>    = 0x00000001,
<a name="l00050"></a>00050 
<a name="l00052"></a><a class="code" href="mw__srvc__resolve_8h.html#58431b16fa3147bd28b20f4d8e046bbbadf46498d1a53c57cd0492dd639eb979">00052</a>   <a class="code" href="mw__srvc__resolve_8h.html#58431b16fa3147bd28b20f4d8e046bbbadf46498d1a53c57cd0492dd639eb979" title="return only the first result">mwResolveFlag_FIRST</a>     = 0x00000002,
<a name="l00053"></a>00053 
<a name="l00055"></a><a class="code" href="mw__srvc__resolve_8h.html#58431b16fa3147bd28b20f4d8e046bbb2d89a6687296226e99cf10d103e98937">00055</a>   <a class="code" href="mw__srvc__resolve_8h.html#58431b16fa3147bd28b20f4d8e046bbb2d89a6687296226e99cf10d103e98937" title="search all directories, not just the first with a match">mwResolveFlag_ALL_DIRS</a>  = 0x00000004,
<a name="l00056"></a>00056 
<a name="l00058"></a><a class="code" href="mw__srvc__resolve_8h.html#58431b16fa3147bd28b20f4d8e046bbbaf2857a1f0eafa23d3c1b2b4b46f136a">00058</a>   <a class="code" href="mw__srvc__resolve_8h.html#58431b16fa3147bd28b20f4d8e046bbbaf2857a1f0eafa23d3c1b2b4b46f136a" title="search for users">mwResolveFlag_USERS</a>     = 0x00000008,
<a name="l00059"></a>00059 
<a name="l00061"></a><a class="code" href="mw__srvc__resolve_8h.html#58431b16fa3147bd28b20f4d8e046bbbdb90560d6d73e2b2d04d2c6ace65d4e7">00061</a>   <a class="code" href="mw__srvc__resolve_8h.html#58431b16fa3147bd28b20f4d8e046bbbdb90560d6d73e2b2d04d2c6ace65d4e7" title="search for groups">mwResolveFlag_GROUPS</a>    = 0x00000010,
<a name="l00062"></a>00062 };
<a name="l00063"></a>00063 
<a name="l00064"></a>00064 
<a name="l00066"></a><a class="code" href="mw__srvc__resolve_8h.html#901802d0ba547de6e2bbc51e7f8c961e">00066</a> <span class="keyword">enum</span> <a class="code" href="mw__srvc__resolve_8h.html#901802d0ba547de6e2bbc51e7f8c961e" title="mwResolveResult">mwResolveCode</a> {
<a name="l00068"></a><a class="code" href="mw__srvc__resolve_8h.html#901802d0ba547de6e2bbc51e7f8c961e52b065bd666703cdaae31c230e852679">00068</a>   <a class="code" href="mw__srvc__resolve_8h.html#901802d0ba547de6e2bbc51e7f8c961e52b065bd666703cdaae31c230e852679" title="successful search">mwResolveCode_SUCCESS</a>     = 0x00000000,
<a name="l00069"></a>00069 
<a name="l00071"></a><a class="code" href="mw__srvc__resolve_8h.html#901802d0ba547de6e2bbc51e7f8c961e59051750774c2af1a16af178e4a63772">00071</a>   <a class="code" href="mw__srvc__resolve_8h.html#901802d0ba547de6e2bbc51e7f8c961e59051750774c2af1a16af178e4a63772" title="only some of the nested searches were successful">mwResolveCode_PARTIAL</a>     = 0x00010000,
<a name="l00072"></a>00072 
<a name="l00075"></a><a class="code" href="mw__srvc__resolve_8h.html#901802d0ba547de6e2bbc51e7f8c961e2e3a8627f18371c9706af74e4d0f3ef7">00075</a>   <a class="code" href="mw__srvc__resolve_8h.html#901802d0ba547de6e2bbc51e7f8c961e2e3a8627f18371c9706af74e4d0f3ef7" title="more than one result (occurs when mwResolveFlag_UNIQUE is used and more than one...">mwResolveCode_MULTIPLE</a>    = 0x80020000,
<a name="l00076"></a>00076 
<a name="l00078"></a><a class="code" href="mw__srvc__resolve_8h.html#901802d0ba547de6e2bbc51e7f8c961e274747836537e0153801c07a7526fff2">00078</a>   <a class="code" href="mw__srvc__resolve_8h.html#901802d0ba547de6e2bbc51e7f8c961e274747836537e0153801c07a7526fff2" title="the name is not resolvable due to its format">mwResolveCode_BAD_FORMAT</a>  = 0x80030000,
<a name="l00079"></a>00079 };
<a name="l00080"></a>00080 
<a name="l00081"></a>00081 
<a name="l00082"></a><a class="code" href="mw__srvc__resolve_8h.html#97de48c2ed31a8dd2155de1543a41591">00082</a> <span class="keyword">enum</span> <a class="code" href="mw__srvc__resolve_8h.html#97de48c2ed31a8dd2155de1543a41591">mwResolveMatchType</a> {
<a name="l00083"></a><a class="code" href="mw__srvc__resolve_8h.html#97de48c2ed31a8dd2155de1543a41591ceb17ee67694939b111d1a35000a63c3">00083</a>   <a class="code" href="mw__srvc__resolve_8h.html#97de48c2ed31a8dd2155de1543a41591ceb17ee67694939b111d1a35000a63c3">mwResolveMatch_USER</a>   = 0x00000001,
<a name="l00084"></a><a class="code" href="mw__srvc__resolve_8h.html#97de48c2ed31a8dd2155de1543a41591208dda549a0228435744b5474dd142e6">00084</a>   <a class="code" href="mw__srvc__resolve_8h.html#97de48c2ed31a8dd2155de1543a41591208dda549a0228435744b5474dd142e6">mwResolveMatch_GROUP</a>  = 0x00000002,
<a name="l00085"></a>00085 };
<a name="l00086"></a>00086 
<a name="l00087"></a>00087 
<a name="l00088"></a><a class="code" href="structmwResolveMatch.html">00088</a> <span class="keyword">struct </span><a class="code" href="structmwResolveMatch.html">mwResolveMatch</a> {
<a name="l00089"></a><a class="code" href="structmwResolveMatch.html#545c470ba6285f98eb59e5a33aca3e65">00089</a>   <span class="keywordtype">char</span> *<a class="code" href="structmwResolveMatch.html#545c470ba6285f98eb59e5a33aca3e65" title="user id">id</a>;      
<a name="l00090"></a><a class="code" href="structmwResolveMatch.html#0565999113451b9b49aae9bdae53643c">00090</a>   <span class="keywordtype">char</span> *<a class="code" href="structmwResolveMatch.html#0565999113451b9b49aae9bdae53643c" title="user name">name</a>;    
<a name="l00091"></a><a class="code" href="structmwResolveMatch.html#c5feea68842e2ef0a4d927c03e847807">00091</a>   <span class="keywordtype">char</span> *<a class="code" href="structmwResolveMatch.html#c5feea68842e2ef0a4d927c03e847807" title="description">desc</a>;    
<a name="l00092"></a><a class="code" href="structmwResolveMatch.html#f772b7a9845b14f661eaeb01c60365ae">00092</a>   guint32 <a class="code" href="structmwResolveMatch.html#f772b7a9845b14f661eaeb01c60365ae" title="mwResolveMatchType">type</a>;  
<a name="l00093"></a>00093 };
<a name="l00094"></a>00094 
<a name="l00095"></a>00095 
<a name="l00096"></a><a class="code" href="structmwResolveResult.html">00096</a> <span class="keyword">struct </span><a class="code" href="structmwResolveResult.html">mwResolveResult</a> {
<a name="l00097"></a><a class="code" href="structmwResolveResult.html#03cc6b9199944c9cdc4b5846a4d76fdc">00097</a>   guint32 <a class="code" href="structmwResolveResult.html#03cc6b9199944c9cdc4b5846a4d76fdc" title="mwResolveCode">code</a>;    
<a name="l00098"></a><a class="code" href="structmwResolveResult.html#9c8296a096ead70186242b2651fb7746">00098</a>   <span class="keywordtype">char</span> *<a class="code" href="structmwResolveResult.html#9c8296a096ead70186242b2651fb7746" title="name of the result">name</a>;      
<a name="l00099"></a><a class="code" href="structmwResolveResult.html#805ee433c84b8e47fcb273b62ca86a85">00099</a>   GList *<a class="code" href="structmwResolveResult.html#805ee433c84b8e47fcb273b62ca86a85" title="list of mwResolveMatch">matches</a>;  
<a name="l00100"></a>00100 };
<a name="l00101"></a>00101 
<a name="l00102"></a>00102 
<a name="l00113"></a>00113 <span class="keyword">typedef</span> void (*<a class="code" href="mw__srvc__resolve_8h.html#753578369cb87a8e7ee163c371ab2ed4" title="Handle the results of a resolve request.">mwResolveHandler</a>)
<a name="l00114"></a><a class="code" href="mw__srvc__resolve_8h.html#753578369cb87a8e7ee163c371ab2ed4">00114</a>      (<span class="keyword">struct </span><a class="code" href="structmwServiceResolve.html" title="User lookup service.">mwServiceResolve</a> *srvc,
<a name="l00115"></a>00115       guint32 id, guint32 code, GList *results,
<a name="l00116"></a>00116       gpointer data);
<a name="l00117"></a>00117 
<a name="l00118"></a>00118 
<a name="l00120"></a>00120 <span class="keyword">struct </span><a class="code" href="structmwServiceResolve.html" title="User lookup service.">mwServiceResolve</a> *<a class="code" href="mw__srvc__resolve_8h.html#bbd09e01eef8b1a275177926edcbfaaa" title="Allocate a new resolve service.">mwServiceResolve_new</a>(<span class="keyword">struct</span> <a class="code" href="structmwSession.html" title="Represents a Sametime client session.">mwSession</a> *);
<a name="l00121"></a>00121 
<a name="l00122"></a>00122 
<a name="l00133"></a>00133 guint32 <a class="code" href="mw__srvc__resolve_8h.html#c3417bb30fa92f4e6897fb5b71f8ba65" title="Inisitate a resolve request.">mwServiceResolve_resolve</a>(<span class="keyword">struct</span> <a class="code" href="structmwServiceResolve.html" title="User lookup service.">mwServiceResolve</a> *srvc,
<a name="l00134"></a>00134                                  GList *queries, <span class="keyword">enum</span> <a class="code" href="mw__srvc__resolve_8h.html#58431b16fa3147bd28b20f4d8e046bbb">mwResolveFlag</a> flags,
<a name="l00135"></a>00135                                  <a class="code" href="mw__srvc__resolve_8h.html#753578369cb87a8e7ee163c371ab2ed4" title="Handle the results of a resolve request.">mwResolveHandler</a> handler,
<a name="l00136"></a>00136                                  gpointer data, GDestroyNotify cleanup);
<a name="l00137"></a>00137 
<a name="l00138"></a>00138 
<a name="l00142"></a>00142 <span class="keywordtype">void</span> <a class="code" href="mw__srvc__resolve_8h.html#b0158070e293d0d6a4f7aeac84130add" title="Cancel a resolve request by its generated ID.">mwServiceResolve_cancelResolve</a>(<span class="keyword">struct</span> <a class="code" href="structmwServiceResolve.html" title="User lookup service.">mwServiceResolve</a> *, guint32);
<a name="l00143"></a>00143 
<a name="l00144"></a>00144 
<a name="l00145"></a>00145 <span class="preprocessor">#ifdef __cplusplus</span>
<a name="l00146"></a>00146 <span class="preprocessor"></span>}
<a name="l00147"></a>00147 <span class="preprocessor">#endif</span>
<a name="l00148"></a>00148 <span class="preprocessor"></span>
<a name="l00149"></a>00149 
<a name="l00150"></a>00150 <span class="preprocessor">#endif </span><span class="comment">/* _MW_SRVC_RESOLVE_H */</span>
</pre></div><hr size="1"><address style="text-align: right;"><small>Generated on Wed Dec 19 09:10:34 2007 for meanwhile by&nbsp;
<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>