Mercurial > pidgin
comparison src/proxy.h @ 11211:03a244acce57
[gaim-migrate @ 13342]
(14:28:27) Christopher O'Brien (siege): ArdentlyGnarly, gaim_proxy_connect's docs lie
(14:28:36) Christopher O'Brien (siege): it doesn't return a fd
(14:28:52) Christopher O'Brien (siege): it returns a status code
...
(14:37:58) rlaager: siege, ArdentlyGnarly: We should correct the docs for gaim_proxy_connect... how does this sound? "@return zero for success, any other value for failure"
...
(14:39:22) Jonathan Clark (ArdentlyGnarly): we really don't know whether or not the call was successful at the time it returns
(14:39:55) Jonathan Clark (ArdentlyGnarly): we get that information when things get back around to the callback passed to gaim_proxy_connect
(14:42:08) Jonathan Clark (ArdentlyGnarly): perhaps: @return zero indicates connection is pending, any other value for failure
committer: Tailor Script <tailor@pidgin.im>
author | Richard Laager <rlaager@wiktel.com> |
---|---|
date | Mon, 08 Aug 2005 19:45:28 +0000 |
parents | 9fdbfe832fac |
children | c39a48818f66 |
comparison
equal
deleted
inserted
replaced
11210:5ba038e1b21f | 11211:03a244acce57 |
---|---|
207 * @param host The destination host. | 207 * @param host The destination host. |
208 * @param port The destination port. | 208 * @param port The destination port. |
209 * @param func The input handler function. | 209 * @param func The input handler function. |
210 * @param data User-defined data. | 210 * @param data User-defined data. |
211 * | 211 * |
212 * @return The socket handle. | 212 * @return Zero indicates the connection is pending. Any other value indicates failure. |
213 */ | 213 */ |
214 int gaim_proxy_connect(GaimAccount *account, const char *host, int port, | 214 int gaim_proxy_connect(GaimAccount *account, const char *host, int port, |
215 GaimInputFunction func, gpointer data); | 215 GaimInputFunction func, gpointer data); |
216 | 216 |
217 /** | 217 /** |
221 * @param host The destination host. | 221 * @param host The destination host. |
222 * @param port The destination port. | 222 * @param port The destination port. |
223 * @param func The input handler function. | 223 * @param func The input handler function. |
224 * @param data User-defined data. | 224 * @param data User-defined data. |
225 * | 225 * |
226 * @return The socket handle. | 226 * @return Zero indicates the connection is pending. Any other value indicates failure. |
227 */ | 227 */ |
228 int gaim_proxy_connect_socks5(GaimProxyInfo *gpi, const char *host, int port, | 228 int gaim_proxy_connect_socks5(GaimProxyInfo *gpi, const char *host, int port, |
229 GaimInputFunction func, gpointer data); | 229 GaimInputFunction func, gpointer data); |
230 | 230 |
231 /*@}*/ | 231 /*@}*/ |