Mercurial > pidgin.yaz
comparison libpurple/dnsquery.h @ 32474:f22bc8b5b9dc
Replace purple_dnsquery_a_account with purple_dnsquery_a.
author | Elliott Sales de Andrade <qulogic@pidgin.im> |
---|---|
date | Fri, 02 Sep 2011 01:57:25 +0000 |
parents | 92f3d821653f |
children |
comparison
equal
deleted
inserted
replaced
32473:3340d322c8f8 | 32474:f22bc8b5b9dc |
---|---|
86 /*@{*/ | 86 /*@{*/ |
87 | 87 |
88 /** | 88 /** |
89 * Perform an asynchronous DNS query. | 89 * Perform an asynchronous DNS query. |
90 * | 90 * |
91 * @param account the account that the query is being done for (or NULL) | 91 * @param account The account that the query is being done for (or NULL) |
92 * @param hostname The hostname to resolve. | 92 * @param hostname The hostname to resolve. |
93 * @param port A port number which is stored in the struct sockaddr. | 93 * @param port A port number which is stored in the struct sockaddr. |
94 * @param callback The callback function to call after resolving. | 94 * @param callback The callback function to call after resolving. |
95 * @param data Extra data to pass to the callback function. | 95 * @param data Extra data to pass to the callback function. |
96 * | 96 * |
97 * @return NULL if there was an error, otherwise return a reference to | 97 * @return NULL if there was an error, otherwise return a reference to |
98 * a data structure that can be used to cancel the pending | 98 * a data structure that can be used to cancel the pending |
99 * DNS query, if needed. | 99 * DNS query, if needed. |
100 * | 100 * |
101 * @since 2.8.0 | |
102 */ | 101 */ |
103 PurpleDnsQueryData *purple_dnsquery_a_account(PurpleAccount *account, const char *hostname, int port, PurpleDnsQueryConnectFunction callback, gpointer data); | 102 PurpleDnsQueryData *purple_dnsquery_a(PurpleAccount *account, const char *hostname, int port, PurpleDnsQueryConnectFunction callback, gpointer data); |
104 | |
105 #if !(defined PURPLE_DISABLE_DEPRECATED) || (defined _PURPLE_DNSQUERY_C_) | |
106 /** | |
107 * Perform an asynchronous DNS query. | |
108 * | |
109 * @param hostname The hostname to resolve. | |
110 * @param port A port number which is stored in the struct sockaddr. | |
111 * @param callback The callback function to call after resolving. | |
112 * @param data Extra data to pass to the callback function. | |
113 * | |
114 * @return NULL if there was an error, otherwise return a reference to | |
115 * a data structure that can be used to cancel the pending | |
116 * DNS query, if needed. | |
117 * | |
118 * @deprecated Use purple_dnsquery_a_account instead | |
119 */ | |
120 PurpleDnsQueryData *purple_dnsquery_a(const char *hostname, int port, PurpleDnsQueryConnectFunction callback, gpointer data); | |
121 #endif | |
122 | 103 |
123 /** | 104 /** |
124 * Cancel a DNS query and destroy the associated data structure. | 105 * Cancel a DNS query and destroy the associated data structure. |
125 * | 106 * |
126 * @param query_data The DNS query to cancel. This data structure | 107 * @param query_data The DNS query to cancel. This data structure |