comparison src/dnsquery.h @ 14183:c3c792958635

[gaim-migrate @ 16835] Change the DNS query function to return a struct that will eventually allow the query to be canceled. Also rename two of the DNS query things committer: Tailor Script <[e-mail]>

14182:ccb670ba3b4f

#define _GAIM_DNSQUERY_H_

#include <glib.h>
#include "eventloop.h"

/**
 * The "hosts" parameter is a linked list containing pairs of
 * one size_t addrlen and one struct sockaddr *addr.
 */
typedef void (*GaimProxyDnsConnectFunction)(GSList *hosts, gpointer data, const char *error_message);


#include "account.h"

#ifdef __cplusplus

 * @param hostname The hostname to resolve
 * @param port A portnumber which is stored in the struct sockaddr
 * @param callback Callback to call after resolving
 * @param data Extra data for the callback function
 *
 * @return Zero indicates the connection is pending. Any other value indicates failure.
 */
int gaim_gethostbyname_async(const char *hostname, int port, GaimProxyDnsConnectFunction callback, gpointer data);

/*@}*/

#ifdef __cplusplus
}

14183:c3c792958635

#define _GAIM_DNSQUERY_H_

#include <glib.h>
#include "eventloop.h"

typedef struct _GaimDnsQueryData GaimDnsQueryData;

/**
 * The "hosts" parameter is a linked list containing pairs of
 * one size_t addrlen and one struct sockaddr *addr.
 */
typedef void (*GaimDnsQueryConnectFunction)(GSList *hosts, gpointer data, const char *error_message);


#include "account.h"

#ifdef __cplusplus

 * @param hostname The hostname to resolve
 * @param port A portnumber which is stored in the struct sockaddr
 * @param callback Callback to call after resolving
 * @param data Extra data for the callback function
 *
 * @return NULL if there was an error, otherwise return a reference to
 *         a data structure that can be used to cancel the pending
 *         DNS query, if needed.
 */
GaimDnsQueryData *gaim_dnsquery_a(const char *hostname, int port, GaimDnsQueryConnectFunction callback, gpointer data);

/*@}*/

#ifdef __cplusplus
}