gproxyresolver.h 3.4 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697
  1. /* GIO - GLib Input, Output and Streaming Library
  2. *
  3. * Copyright (C) 2010 Collabora, Ltd.
  4. *
  5. * SPDX-License-Identifier: LGPL-2.1-or-later
  6. *
  7. * This library is free software; you can redistribute it and/or
  8. * modify it under the terms of the GNU Lesser General Public
  9. * License as published by the Free Software Foundation; either
  10. * version 2.1 of the License, or (at your option) any later version.
  11. *
  12. * This library is distributed in the hope that it will be useful,
  13. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  15. * Lesser General Public License for more details.
  16. *
  17. * You should have received a copy of the GNU Lesser General
  18. * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
  19. *
  20. * Author: Nicolas Dufresne <nicolas.dufresne@collabora.co.uk>
  21. */
  22. #ifndef __G_PROXY_RESOLVER_H__
  23. #define __G_PROXY_RESOLVER_H__
  24. #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
  25. #error "Only <gio/gio.h> can be included directly."
  26. #endif
  27. #include <gio/giotypes.h>
  28. G_BEGIN_DECLS
  29. #define G_TYPE_PROXY_RESOLVER (g_proxy_resolver_get_type ())
  30. #define G_PROXY_RESOLVER(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_PROXY_RESOLVER, GProxyResolver))
  31. #define G_IS_PROXY_RESOLVER(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_PROXY_RESOLVER))
  32. #define G_PROXY_RESOLVER_GET_IFACE(o) (G_TYPE_INSTANCE_GET_INTERFACE ((o), G_TYPE_PROXY_RESOLVER, GProxyResolverInterface))
  33. /**
  34. * G_PROXY_RESOLVER_EXTENSION_POINT_NAME:
  35. *
  36. * Extension point for proxy resolving functionality.
  37. * See [Extending GIO][extending-gio].
  38. */
  39. #define G_PROXY_RESOLVER_EXTENSION_POINT_NAME "gio-proxy-resolver"
  40. typedef struct _GProxyResolverInterface GProxyResolverInterface;
  41. struct _GProxyResolverInterface {
  42. GTypeInterface g_iface;
  43. /* Virtual Table */
  44. gboolean (* is_supported) (GProxyResolver *resolver);
  45. gchar ** (* lookup) (GProxyResolver *resolver,
  46. const gchar *uri,
  47. GCancellable *cancellable,
  48. GError **error);
  49. void (* lookup_async) (GProxyResolver *resolver,
  50. const gchar *uri,
  51. GCancellable *cancellable,
  52. GAsyncReadyCallback callback,
  53. gpointer user_data);
  54. gchar ** (* lookup_finish) (GProxyResolver *resolver,
  55. GAsyncResult *result,
  56. GError **error);
  57. };
  58. GIO_AVAILABLE_IN_ALL
  59. GType g_proxy_resolver_get_type (void) G_GNUC_CONST;
  60. GIO_AVAILABLE_IN_ALL
  61. GProxyResolver *g_proxy_resolver_get_default (void);
  62. GIO_AVAILABLE_IN_ALL
  63. gboolean g_proxy_resolver_is_supported (GProxyResolver *resolver);
  64. GIO_AVAILABLE_IN_ALL
  65. gchar **g_proxy_resolver_lookup (GProxyResolver *resolver,
  66. const gchar *uri,
  67. GCancellable *cancellable,
  68. GError **error);
  69. GIO_AVAILABLE_IN_ALL
  70. void g_proxy_resolver_lookup_async (GProxyResolver *resolver,
  71. const gchar *uri,
  72. GCancellable *cancellable,
  73. GAsyncReadyCallback callback,
  74. gpointer user_data);
  75. GIO_AVAILABLE_IN_ALL
  76. gchar **g_proxy_resolver_lookup_finish (GProxyResolver *resolver,
  77. GAsyncResult *result,
  78. GError **error);
  79. G_END_DECLS
  80. #endif /* __G_PROXY_RESOLVER_H__ */