meanwhile 1.0.2
mw_srvc_resolve.h
Go to the documentation of this file.
1
2/*
3 Meanwhile - Unofficial Lotus Sametime Community Client Library
4 Copyright (C) 2004 Christopher (siege) O'Brien
5
6 This library is free software; you can redistribute it and/or
7 modify it under the terms of the GNU Library General Public
8 License as published by the Free Software Foundation; either
9 version 2 of the License, or (at your option) any later version.
10
11 This library is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 Library General Public License for more details.
15
16 You should have received a copy of the GNU Library General Public
17 License along with this library; if not, write to the Free
18 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19*/
20
21#ifndef _MW_SRVC_RESOLVE_H
22#define _MW_SRVC_RESOLVE_H
23
24
25#include <glib.h>
26#include <glib.h>
27
28
29#ifdef __cplusplus
30extern "C" {
31#endif
32
33
35#define mwService_RESOLVE 0x00000015
36
37
39#define SEARCH_ERROR 0x00
40
41
44struct mwServiceResolve;
45
46
50
52 mwResolveFlag_FIRST = 0x00000002,
53
56
58 mwResolveFlag_USERS = 0x00000008,
59
62};
63
64
69
72
76
79};
80
81
83 mwResolveMatch_USER = 0x00000001,
85};
86
87
89 char *id;
90 char *name;
91 char *desc;
92 guint32 type;
93};
94
95
97 guint32 code;
98 char *name;
99 GList *matches;
100};
101
102
113typedef void (*mwResolveHandler)
114 (struct mwServiceResolve *srvc,
115 guint32 id, guint32 code, GList *results,
116 gpointer data);
117
118
121
122
134 GList *queries, enum mwResolveFlag flags,
135 mwResolveHandler handler,
136 gpointer data, GDestroyNotify cleanup);
137
138
143
144
145#ifdef __cplusplus
146}
147#endif
148
149
150#endif /* _MW_SRVC_RESOLVE_H */
void(* mwResolveHandler)(struct mwServiceResolve *srvc, guint32 id, guint32 code, GList *results, gpointer data)
Handle the results of a resolve request.
Definition: mw_srvc_resolve.h:114
struct mwServiceResolve * mwServiceResolve_new(struct mwSession *)
Allocate a new resolve service.
mwResolveFlag
Definition: mw_srvc_resolve.h:47
@ mwResolveFlag_UNIQUE
return unique results or none at all
Definition: mw_srvc_resolve.h:49
@ mwResolveFlag_ALL_DIRS
search all directories, not just the first with a match
Definition: mw_srvc_resolve.h:55
@ mwResolveFlag_FIRST
return only the first result
Definition: mw_srvc_resolve.h:52
@ mwResolveFlag_USERS
search for users
Definition: mw_srvc_resolve.h:58
@ mwResolveFlag_GROUPS
search for groups
Definition: mw_srvc_resolve.h:61
mwResolveCode
Definition: mw_srvc_resolve.h:66
@ mwResolveCode_BAD_FORMAT
the name is not resolvable due to its format
Definition: mw_srvc_resolve.h:78
@ mwResolveCode_MULTIPLE
more than one result (occurs when mwResolveFlag_UNIQUE is used and more than one result would have be...
Definition: mw_srvc_resolve.h:75
@ mwResolveCode_SUCCESS
successful search
Definition: mw_srvc_resolve.h:68
@ mwResolveCode_PARTIAL
only some of the nested searches were successful
Definition: mw_srvc_resolve.h:71
mwResolveMatchType
Definition: mw_srvc_resolve.h:82
@ mwResolveMatch_GROUP
Definition: mw_srvc_resolve.h:84
@ mwResolveMatch_USER
Definition: mw_srvc_resolve.h:83
void mwServiceResolve_cancelResolve(struct mwServiceResolve *, guint32)
Cancel a resolve request by its generated ID.
guint32 mwServiceResolve_resolve(struct mwServiceResolve *srvc, GList *queries, enum mwResolveFlag flags, mwResolveHandler handler, gpointer data, GDestroyNotify cleanup)
Inisitate a resolve request.
Definition: mw_srvc_resolve.h:88
char * name
user name
Definition: mw_srvc_resolve.h:90
char * id
user id
Definition: mw_srvc_resolve.h:89
char * desc
description
Definition: mw_srvc_resolve.h:91
guint32 type
Definition: mw_srvc_resolve.h:92
Definition: mw_srvc_resolve.h:96
guint32 code
Definition: mw_srvc_resolve.h:97
GList * matches
list of mwResolveMatch
Definition: mw_srvc_resolve.h:99
char * name
name of the result
Definition: mw_srvc_resolve.h:98
User lookup service.
Represents a Sametime client session.