Changeset 879 for pjproject/trunk/pjsip/include/pjsip/sip_dialog.h

Timestamp:

Jan 12, 2007 6:37:35 AM (17 years ago)

Author:

bennylp

Message:

Workaround for ticket #50: added API to lock/bind transaction, dialog, and regc to a specific transport/listener

File:

• pjproject/trunk/pjsip/include/pjsip/sip_dialog.h (modified) (3 diffs)

pjproject/trunk/pjsip/include/pjsip/sip_dialog.h

@@ -29 +29 @@
 #include <pjsip/sip_auth.h>
 #include <pjsip/sip_errno.h>
+#include <pjsip/sip_transport.h>
 #include <pj/sock.h>
 #include <pj/assert.h>
@@ -135 +136 @@
     int                 tsx_count;  /**< Number of pending transactions.    */
 
+    /** Transport selector. */
+    pjsip_tpselector    tp_sel;
+
     /* Dialog usages. */
     unsigned            usage_cnt;  /**< Number of registered usages.       */
@@ -225 +229 @@
 
 /**
+ * Lock/bind dialog to a specific transport/listener. This is optional,
+ * as normally transport will be selected automatically based on the 
+ * destination of requests upon resolver completion. When the dialog is 
+ * explicitly bound to the specific transport/listener, all UAC transactions
+ * originated by this dialog will use the specified transport/listener
+ * when sending outgoing requests.
+ *
+ * Note that this doesn't affect the Contact header generated by this
+ * dialog. Application must manually update the Contact header if
+ * necessary, to adjust the address according to the transport being
+ * selected.
+ *
+ * @param dlg       The dialog instance.
+ * @param sel       Transport selector containing the specification of
+ *                  transport or listener to be used by this dialog
+ *                  to send requests.
+ *
+ * @return          PJ_SUCCESS on success, or the appropriate error code.
+ */
+PJ_DECL(pj_status_t) pjsip_dlg_set_transport(pjsip_dialog *dlg,
+                                             const pjsip_tpselector *sel);
+
+
+/**
  * Create a new (forked) dialog on receipt on forked response in rdata. 
  * The new dialog will be created from original_dlg, except that it will have