Mercurial > pidgin.yaz
annotate src/protocols/msn/session.h @ 9158:c30d81b4dd22
[gaim-migrate @ 9942]
Patch from Felipe Contreras to sync our MSN prpl with what's in his tree.
He says this may fix a couple bugs, but the important thing is the
restructuring of how MsnMessages work. Lots of style changes and other
stuff as well.
committer: Tailor Script <tailor@pidgin.im>
author | Christian Hammond <chipx86@chipx86.com> |
---|---|
date | Tue, 01 Jun 2004 06:42:20 +0000 |
parents | bbd8cdaf0ad5 |
children | 502707ca1836 |
rev | line source |
---|---|
5309 | 1 /** |
2 * @file session.h MSN session functions | |
3 * | |
4 * gaim | |
5 * | |
8475
06f57183e29f
[gaim-migrate @ 9208]
Christian Hammond <chipx86@chipx86.com>
parents:
8298
diff
changeset
|
6 * Copyright (C) 2003-2004 Christian Hammond <chipx86@gnupdate.org> |
6701
b7e113a59b51
[gaim-migrate @ 7227]
Christian Hammond <chipx86@chipx86.com>
parents:
5898
diff
changeset
|
7 * |
5309 | 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 #ifndef _MSN_SESSION_H_ | |
23 #define _MSN_SESSION_H_ | |
24 | |
25 typedef struct _MsnSession MsnSession; | |
26 | |
8171
d0ba2f7b40e7
[gaim-migrate @ 8884]
Christian Hammond <chipx86@chipx86.com>
parents:
7631
diff
changeset
|
27 #include "group.h" |
d0ba2f7b40e7
[gaim-migrate @ 8884]
Christian Hammond <chipx86@chipx86.com>
parents:
7631
diff
changeset
|
28 #include "nexus.h" |
d0ba2f7b40e7
[gaim-migrate @ 8884]
Christian Hammond <chipx86@chipx86.com>
parents:
7631
diff
changeset
|
29 #include "servconn.h" |
6701
b7e113a59b51
[gaim-migrate @ 7227]
Christian Hammond <chipx86@chipx86.com>
parents:
5898
diff
changeset
|
30 #include "sslconn.h" |
5309 | 31 #include "switchboard.h" |
32 #include "user.h" | |
8171
d0ba2f7b40e7
[gaim-migrate @ 8884]
Christian Hammond <chipx86@chipx86.com>
parents:
7631
diff
changeset
|
33 |
5309 | 34 |
35 struct _MsnSession | |
36 { | |
5564
187c740f2a4e
[gaim-migrate @ 5966]
Christian Hammond <chipx86@chipx86.com>
parents:
5518
diff
changeset
|
37 GaimAccount *account; |
5363
ebebc833cf77
[gaim-migrate @ 5739]
Christian Hammond <chipx86@chipx86.com>
parents:
5327
diff
changeset
|
38 MsnUser *user; |
7590
3a48ade4f510
[gaim-migrate @ 8208]
Christian Hammond <chipx86@chipx86.com>
parents:
7288
diff
changeset
|
39 char *away_state; |
5309 | 40 |
7631 | 41 guint protocol_ver; |
6701
b7e113a59b51
[gaim-migrate @ 7227]
Christian Hammond <chipx86@chipx86.com>
parents:
5898
diff
changeset
|
42 |
9158
c30d81b4dd22
[gaim-migrate @ 9942]
Christian Hammond <chipx86@chipx86.com>
parents:
8808
diff
changeset
|
43 char *dispatch_host; |
5309 | 44 int dispatch_port; |
45 | |
46 gboolean connected; | |
47 | |
48 MsnServConn *notification_conn; | |
49 | |
8171
d0ba2f7b40e7
[gaim-migrate @ 8884]
Christian Hammond <chipx86@chipx86.com>
parents:
7631
diff
changeset
|
50 MsnNexus *nexus; |
d0ba2f7b40e7
[gaim-migrate @ 8884]
Christian Hammond <chipx86@chipx86.com>
parents:
7631
diff
changeset
|
51 |
7288
ff9127038a5a
[gaim-migrate @ 7869]
Christian Hammond <chipx86@chipx86.com>
parents:
6701
diff
changeset
|
52 gboolean http_method; |
8298
c719f9a181d4
[gaim-migrate @ 9022]
Christian Hammond <chipx86@chipx86.com>
parents:
8171
diff
changeset
|
53 gint http_poll_timer; |
7288
ff9127038a5a
[gaim-migrate @ 7869]
Christian Hammond <chipx86@chipx86.com>
parents:
6701
diff
changeset
|
54 |
5309 | 55 MsnUsers *users; |
5518
bf2a7a7b739d
[gaim-migrate @ 5918]
Christian Hammond <chipx86@chipx86.com>
parents:
5456
diff
changeset
|
56 MsnGroups *groups; |
5309 | 57 |
8808
bbd8cdaf0ad5
[gaim-migrate @ 9570]
Christian Hammond <chipx86@chipx86.com>
parents:
8583
diff
changeset
|
58 int servconns_count; |
5898
5baeb89ee2d4
[gaim-migrate @ 6330]
Christian Hammond <chipx86@chipx86.com>
parents:
5564
diff
changeset
|
59 GList *servconns; |
5309 | 60 GList *switches; |
61 | |
62 struct | |
63 { | |
64 GSList *forward; | |
65 GSList *reverse; | |
66 GSList *allow; | |
67 GSList *block; | |
68 | |
69 } lists; | |
70 | |
71 struct | |
72 { | |
73 char *kv; | |
74 char *sid; | |
75 char *mspauth; | |
76 unsigned long sl; | |
77 char *file; | |
6701
b7e113a59b51
[gaim-migrate @ 7227]
Christian Hammond <chipx86@chipx86.com>
parents:
5898
diff
changeset
|
78 char *client_ip; |
b7e113a59b51
[gaim-migrate @ 7227]
Christian Hammond <chipx86@chipx86.com>
parents:
5898
diff
changeset
|
79 int client_port; |
5309 | 80 |
81 } passport_info; | |
82 | |
5322
a4d017bee1de
[gaim-migrate @ 5694]
Christian Hammond <chipx86@chipx86.com>
parents:
5318
diff
changeset
|
83 /* You have no idea how much I hate all that is below. */ |
5309 | 84 GaimPlugin *prpl; |
5322
a4d017bee1de
[gaim-migrate @ 5694]
Christian Hammond <chipx86@chipx86.com>
parents:
5318
diff
changeset
|
85 |
6701
b7e113a59b51
[gaim-migrate @ 7227]
Christian Hammond <chipx86@chipx86.com>
parents:
5898
diff
changeset
|
86 /* For MSNP8 and MSNP9. */ |
b7e113a59b51
[gaim-migrate @ 7227]
Christian Hammond <chipx86@chipx86.com>
parents:
5898
diff
changeset
|
87 int num_users; |
b7e113a59b51
[gaim-migrate @ 7227]
Christian Hammond <chipx86@chipx86.com>
parents:
5898
diff
changeset
|
88 int total_users; |
b7e113a59b51
[gaim-migrate @ 7227]
Christian Hammond <chipx86@chipx86.com>
parents:
5898
diff
changeset
|
89 int num_groups; |
b7e113a59b51
[gaim-migrate @ 7227]
Christian Hammond <chipx86@chipx86.com>
parents:
5898
diff
changeset
|
90 int total_groups; |
b7e113a59b51
[gaim-migrate @ 7227]
Christian Hammond <chipx86@chipx86.com>
parents:
5898
diff
changeset
|
91 MsnUser *last_user_added; |
b7e113a59b51
[gaim-migrate @ 7227]
Christian Hammond <chipx86@chipx86.com>
parents:
5898
diff
changeset
|
92 |
b7e113a59b51
[gaim-migrate @ 7227]
Christian Hammond <chipx86@chipx86.com>
parents:
5898
diff
changeset
|
93 /* For MSNP7 and lower. */ |
5456
40e976d42028
[gaim-migrate @ 5844]
Christian Hammond <chipx86@chipx86.com>
parents:
5406
diff
changeset
|
94 gboolean syncing_lists; |
5406
9acf4832c0dc
[gaim-migrate @ 5782]
Christian Hammond <chipx86@chipx86.com>
parents:
5363
diff
changeset
|
95 gboolean lists_synced; |
9acf4832c0dc
[gaim-migrate @ 5782]
Christian Hammond <chipx86@chipx86.com>
parents:
5363
diff
changeset
|
96 |
5322
a4d017bee1de
[gaim-migrate @ 5694]
Christian Hammond <chipx86@chipx86.com>
parents:
5318
diff
changeset
|
97 /* For moving buddies from one group to another. Ugh. */ |
a4d017bee1de
[gaim-migrate @ 5694]
Christian Hammond <chipx86@chipx86.com>
parents:
5318
diff
changeset
|
98 gboolean moving_buddy; |
5327
b716ffc25d2d
[gaim-migrate @ 5700]
Christian Hammond <chipx86@chipx86.com>
parents:
5322
diff
changeset
|
99 char *dest_group_name; |
5518
bf2a7a7b739d
[gaim-migrate @ 5918]
Christian Hammond <chipx86@chipx86.com>
parents:
5456
diff
changeset
|
100 MsnUser *moving_user; |
bf2a7a7b739d
[gaim-migrate @ 5918]
Christian Hammond <chipx86@chipx86.com>
parents:
5456
diff
changeset
|
101 MsnGroup *old_group; |
8499
467b01d02f9c
[gaim-migrate @ 9235]
Christian Hammond <chipx86@chipx86.com>
parents:
8475
diff
changeset
|
102 |
467b01d02f9c
[gaim-migrate @ 9235]
Christian Hammond <chipx86@chipx86.com>
parents:
8475
diff
changeset
|
103 /* The last chat ID. */ |
467b01d02f9c
[gaim-migrate @ 9235]
Christian Hammond <chipx86@chipx86.com>
parents:
8475
diff
changeset
|
104 int last_chat_id; |
5309 | 105 }; |
106 | |
107 /** | |
108 * Creates an MSN session. | |
109 * | |
110 * @param account The account. | |
9158
c30d81b4dd22
[gaim-migrate @ 9942]
Christian Hammond <chipx86@chipx86.com>
parents:
8808
diff
changeset
|
111 * @param server The dispatch server host. |
c30d81b4dd22
[gaim-migrate @ 9942]
Christian Hammond <chipx86@chipx86.com>
parents:
8808
diff
changeset
|
112 * @param port The dispatch server port. |
5309 | 113 * |
114 * @return The new MSN session. | |
115 */ | |
5564
187c740f2a4e
[gaim-migrate @ 5966]
Christian Hammond <chipx86@chipx86.com>
parents:
5518
diff
changeset
|
116 MsnSession *msn_session_new(GaimAccount *account, |
9158
c30d81b4dd22
[gaim-migrate @ 9942]
Christian Hammond <chipx86@chipx86.com>
parents:
8808
diff
changeset
|
117 const char *host, int port); |
5309 | 118 |
119 /** | |
120 * Destroys an MSN session. | |
121 * | |
122 * @param session The MSN session to destroy. | |
123 */ | |
124 void msn_session_destroy(MsnSession *session); | |
125 | |
126 /** | |
127 * Connects to and initiates an MSN session. | |
128 * | |
129 * @param session The MSN session. | |
130 * | |
131 * @return @c TRUE on success, @c FALSE on failure. | |
132 */ | |
133 gboolean msn_session_connect(MsnSession *session); | |
134 | |
135 /** | |
136 * Disconnects from an MSN session. | |
137 * | |
138 * @param session The MSN session. | |
139 */ | |
140 void msn_session_disconnect(MsnSession *session); | |
141 | |
142 /** | |
143 * Opens a new switchboard connection. | |
144 * | |
145 * @param session The MSN session. | |
146 * | |
147 * @return The new switchboard connection. | |
148 */ | |
149 MsnSwitchBoard *msn_session_open_switchboard(MsnSession *session); | |
150 | |
151 /** | |
7590
3a48ade4f510
[gaim-migrate @ 8208]
Christian Hammond <chipx86@chipx86.com>
parents:
7288
diff
changeset
|
152 * Changes the status of the user. |
3a48ade4f510
[gaim-migrate @ 8208]
Christian Hammond <chipx86@chipx86.com>
parents:
7288
diff
changeset
|
153 * |
3a48ade4f510
[gaim-migrate @ 8208]
Christian Hammond <chipx86@chipx86.com>
parents:
7288
diff
changeset
|
154 * @param session The MSN session. |
3a48ade4f510
[gaim-migrate @ 8208]
Christian Hammond <chipx86@chipx86.com>
parents:
7288
diff
changeset
|
155 * @param state The new state. |
3a48ade4f510
[gaim-migrate @ 8208]
Christian Hammond <chipx86@chipx86.com>
parents:
7288
diff
changeset
|
156 */ |
3a48ade4f510
[gaim-migrate @ 8208]
Christian Hammond <chipx86@chipx86.com>
parents:
7288
diff
changeset
|
157 gboolean msn_session_change_status(MsnSession *session, const char *state); |
3a48ade4f510
[gaim-migrate @ 8208]
Christian Hammond <chipx86@chipx86.com>
parents:
7288
diff
changeset
|
158 |
3a48ade4f510
[gaim-migrate @ 8208]
Christian Hammond <chipx86@chipx86.com>
parents:
7288
diff
changeset
|
159 /** |
5309 | 160 * Finds a switch with the given passport. |
161 * | |
162 * @param session The MSN session. | |
163 * @param passport The passport to search for. | |
164 * | |
165 * @return The switchboard, if found. | |
166 */ | |
167 MsnSwitchBoard *msn_session_find_switch_with_passport( | |
168 const MsnSession *session, const char *passport); | |
169 | |
170 /** | |
171 * Finds a switchboard with the given chat ID. | |
172 * | |
173 * @param session The MSN session. | |
174 * @param chat_id The chat ID to search for. | |
175 * | |
176 * @return The switchboard, if found. | |
177 */ | |
178 MsnSwitchBoard *msn_session_find_switch_with_id(const MsnSession *session, | |
179 int chat_id); | |
180 | |
181 /** | |
182 * Finds the first unused switchboard. | |
183 * | |
184 * @param session The MSN session. | |
185 * | |
186 * @return The first unused, writable switchboard, if found. | |
187 */ | |
188 MsnSwitchBoard *msn_session_find_unused_switch(const MsnSession *session); | |
189 | |
190 #endif /* _MSN_SESSION_H_ */ |