|
11414
|
1 /**
|
|
|
2 * @file confer.h
|
|
|
3 *
|
|
|
4 * gaim
|
|
|
5 *
|
|
|
6 * Copyright (C) 2005 Bartosz Oler <bartosz@bzimage.us>
|
|
|
7 *
|
|
|
8 * This program is free software; you can redistribute it and/or modify
|
|
|
9 * it under the terms of the GNU General Public License as published by
|
|
|
10 * the Free Software Foundation; either version 2 of the License, or
|
|
|
11 * (at your option) any later version.
|
|
|
12 *
|
|
|
13 * This program is distributed in the hope that it will be useful,
|
|
|
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
16 * GNU General Public License for more details.
|
|
|
17 *
|
|
|
18 * You should have received a copy of the GNU General Public License
|
|
|
19 * along with this program; if not, write to the Free Software
|
|
|
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
|
21 */
|
|
|
22
|
|
|
23
|
|
|
24 #ifndef _GAIM_GG_CONFER_H
|
|
|
25 #define _GAIM_GG_CONFER_H
|
|
|
26
|
|
|
27 #include "gg.h"
|
|
|
28
|
|
|
29 /**
|
|
|
30 * Finds a CHAT conversation for the current account with the specified name.
|
|
|
31 *
|
|
|
32 * @param gc GaimConnection instance.
|
|
|
33 * @param name Name of the conversation.
|
|
|
34 *
|
|
|
35 * @return GaimConversation or NULL if not found.
|
|
|
36 */
|
|
|
37 GaimConversation *
|
|
|
38 ggp_confer_find_by_name(GaimConnection *gc, const gchar *name);
|
|
|
39
|
|
|
40 /**
|
|
|
41 * Adds the specified UIN to the specified conversation.
|
|
|
42 *
|
|
|
43 * @param gc GaimConnection.
|
|
|
44 * @param chat_name Name of the conversation.
|
|
|
45 */
|
|
|
46 void
|
|
|
47 ggp_confer_participants_add_uin(GaimConnection *gc, const gchar *chat_name, const uin_t uin);
|
|
|
48
|
|
|
49 /**
|
|
|
50 * Add the specified UINs to the specified conversation.
|
|
|
51 *
|
|
|
52 * @param gc GaimConnection.
|
|
|
53 * @param chat_name Name of the conversation.
|
|
|
54 * @param recipients List of the UINs.
|
|
|
55 * @param count Number of the UINs.
|
|
|
56 */
|
|
|
57 void
|
|
|
58 ggp_confer_participants_add(GaimConnection *gc, const gchar *chat_name,
|
|
|
59 const uin_t *recipients, int count);
|
|
|
60
|
|
|
61 /**
|
|
|
62 * Finds a conversation in which all the specified recipients participate.
|
|
|
63 *
|
|
|
64 * TODO: This function should be rewritten to better handle situations when
|
|
|
65 * somebody adds more people to the converation.
|
|
|
66 *
|
|
|
67 * @param gc GaimConnection.
|
|
|
68 * @param recipients List of the people in the conversation.
|
|
|
69 * @param count Number of people.
|
|
|
70 *
|
|
|
71 * @return Name of the conversation.
|
|
|
72 */
|
|
|
73 const char*
|
|
|
74 ggp_confer_find_by_participants(GaimConnection *gc, const uin_t *recipients, int count);
|
|
|
75
|
|
|
76 /**
|
|
|
77 * Adds a new conversation to the internal list of conversations.
|
|
|
78 * If name is NULL then it will be automagically generated.
|
|
|
79 *
|
|
|
80 * @param gc GaimConnection.
|
|
|
81 * @param name Name of the conversation.
|
|
|
82 *
|
|
|
83 * @return Name of the conversation.
|
|
|
84 */
|
|
|
85 const char*
|
|
|
86 ggp_confer_add_new(GaimConnection *gc, const char *name);
|
|
|
87
|
|
|
88
|
|
|
89 #endif /* _GAIM_GG_CONFER_H */
|
|
|
90
|
|
|
91 /* vim: set ts=4 sts=0 sw=4 noet: */
|
