meanwhile 1.1.1
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
27
28#ifdef __cplusplus
29extern "C" {
30#endif
31
32
34#define mwService_RESOLVE 0x00000015
35
36
38#define SEARCH_ERROR 0x00
39
40
43struct mwServiceResolve;
44
45
49
51 mwResolveFlag_FIRST = 0x00000002,
52
55
57 mwResolveFlag_USERS = 0x00000008,
58
61};
62
63
68
71
75
78};
79
80
85
86
88 char *id;
89 char *name;
90 char *desc;
91 guint32 type;
92};
93
94
96 guint32 code;
97 char *name;
98 GList *matches;
99};
100
101
112typedef void (*mwResolveHandler)
113 (struct mwServiceResolve *srvc,
114 guint32 id, guint32 code, GList *results,
115 gpointer data);
116
117
120
121
133 GList *queries, enum mwResolveFlag flags,
134 mwResolveHandler handler,
135 gpointer data, GDestroyNotify cleanup);
136
137
142
143
144#ifdef __cplusplus
145}
146#endif
147
148
149#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:113
struct mwServiceResolve * mwServiceResolve_new(struct mwSession *)
Allocate a new resolve service.
mwResolveFlag
Definition mw_srvc_resolve.h:46
@ mwResolveFlag_UNIQUE
return unique results or none at all
Definition mw_srvc_resolve.h:48
@ mwResolveFlag_ALL_DIRS
search all directories, not just the first with a match
Definition mw_srvc_resolve.h:54
@ mwResolveFlag_FIRST
return only the first result
Definition mw_srvc_resolve.h:51
@ mwResolveFlag_USERS
search for users
Definition mw_srvc_resolve.h:57
@ mwResolveFlag_GROUPS
search for groups
Definition mw_srvc_resolve.h:60
mwResolveCode
Definition mw_srvc_resolve.h:65
@ mwResolveCode_BAD_FORMAT
the name is not resolvable due to its format
Definition mw_srvc_resolve.h:77
@ 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:74
@ mwResolveCode_SUCCESS
successful search
Definition mw_srvc_resolve.h:67
@ mwResolveCode_PARTIAL
only some of the nested searches were successful
Definition mw_srvc_resolve.h:70
mwResolveMatchType
Definition mw_srvc_resolve.h:81
@ mwResolveMatch_GROUP
Definition mw_srvc_resolve.h:83
@ mwResolveMatch_USER
Definition mw_srvc_resolve.h:82
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:87
char * name
user name
Definition mw_srvc_resolve.h:89
char * id
user id
Definition mw_srvc_resolve.h:88
char * desc
description
Definition mw_srvc_resolve.h:90
guint32 type
Definition mw_srvc_resolve.h:91
Definition mw_srvc_resolve.h:95
guint32 code
Definition mw_srvc_resolve.h:96
GList * matches
list of mwResolveMatch
Definition mw_srvc_resolve.h:98
char * name
name of the result
Definition mw_srvc_resolve.h:97
User lookup service.
Represents a Sametime client session.