comparison libpurple/dnsquery.h @ 19965:47ad1aeae4aa

Add doxygen fu to the DNS UiOps.
author Will Thompson <will.thompson@collabora.co.uk>
date Wed, 15 Aug 2007 22:06:40 +0000
parents 516f14bef90e
children 96cab0f92851
comparison
equal deleted inserted replaced
19283:39df1370839e 19965:47ad1aeae4aa
43 */ 43 */
44 typedef void (*PurpleDnsQueryResolvedCallback) (PurpleDnsQueryData *query_data, GSList *hosts); 44 typedef void (*PurpleDnsQueryResolvedCallback) (PurpleDnsQueryData *query_data, GSList *hosts);
45 typedef void (*PurpleDnsQueryFailedCallback) (PurpleDnsQueryData *query_data, const gchar *error_message); 45 typedef void (*PurpleDnsQueryFailedCallback) (PurpleDnsQueryData *query_data, const gchar *error_message);
46 46
47 /** 47 /**
48 * DNS Request UI operations 48 * DNS Request UI operations; UIs should implement this if they want to do DNS
49 * lookups themselves, rather than relying on the core.
50 *
51 * @see @ref ui-ops
49 */ 52 */
50 typedef struct 53 typedef struct
51 { 54 {
52 /* If implemented, the UI is responsible for DNS queries */ 55 /** If implemented, the UI is responsible for DNS queries */
53 gboolean (*resolve_host)(PurpleDnsQueryData *query_data, PurpleDnsQueryResolvedCallback resolved_cb, PurpleDnsQueryFailedCallback failed_cb); 56 gboolean (*resolve_host)(PurpleDnsQueryData *query_data,
57 PurpleDnsQueryResolvedCallback resolved_cb,
58 PurpleDnsQueryFailedCallback failed_cb);
54 59
55 /* After destroy is called, query_data will be feed, so this must 60 /** Called just before @a query_data is freed; this should cancel any
56 * cancel any further use of it the UI would do. Unneeded if 61 * further use of @q query_data the UI would make. Unneeded if
57 * resolve_host is not implemented. 62 * #resolve_host is not implemented.
58 */ 63 */
59 void (*destroy)(PurpleDnsQueryData *query_data); 64 void (*destroy)(PurpleDnsQueryData *query_data);
60 65
61 void (*_purple_reserved1)(void); 66 void (*_purple_reserved1)(void);
62 void (*_purple_reserved2)(void); 67 void (*_purple_reserved2)(void);