Changeset 2387 for pjproject/trunk/pjlib-util/include/pjlib-util/srv_resolver.h

Timestamp:

Dec 19, 2008 12:26:42 PM (16 years ago)

Author:

bennylp

Message:

Fixed ticket #686: Failure to cancel outstanding DNS SRV query job (API change)

File:

• pjproject/trunk/pjlib-util/include/pjlib-util/srv_resolver.h (modified) (2 diffs)

pjproject/trunk/pjlib-util/include/pjlib-util/srv_resolver.h

@@ -137 +137 @@
 } pj_dns_srv_record;
 
+
+/** Opaque declaration for DNS SRV query */
+typedef struct pj_dns_srv_async_query pj_dns_srv_async_query;
 
 /**
@@ -185 +188 @@
                                         void *token,
                                         pj_dns_srv_resolver_cb *cb,
-                                        pj_dns_async_query **p_query);
+                                        pj_dns_srv_async_query **p_query);
+
+
+/**
+ * Cancel an outstanding DNS SRV query.
+ *
+ * @param query     The pending asynchronous query to be cancelled.
+ * @param notify    If non-zero, the callback will be called with failure
+ *                  status to notify that the query has been cancelled.
+ *
+ * @return          PJ_SUCCESS on success, or the appropriate error code,
+ */
+PJ_DECL(pj_status_t) pj_dns_srv_cancel_query(pj_dns_srv_async_query *query,
+                                             pj_bool_t notify);