Changeset 879 for pjproject/trunk/pjsip/include/pjsip/sip_endpoint.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_endpoint.h (modified) (2 diffs)

pjproject/trunk/pjsip/include/pjsip/sip_endpoint.h

@@ -353 +353 @@
 /**
  * Find a SIP transport suitable for sending SIP message to the specified
- * address. This function will complete asynchronously when the transport is
- * ready (for example, when TCP socket is connected), and when it completes,
- * the callback will be called with the status of the operation.
- *
- * @see pjsip_transport_get
+ * address. If transport selector ("sel") is set, then the function will
+ * check if the transport selected is suitable to send requests to the
+ * specified address.
+ *
+ * @see pjsip_tpmgr_acquire_transport
+ *
+ * @param endpt     The SIP endpoint instance.
+ * @param type      The type of transport to be acquired.
+ * @param remote    The remote address to send message to.
+ * @param addr_len  Length of the remote address.
+ * @param sel       Optional pointer to transport selector instance which is
+ *                  used to find explicit transport, if required.
+ * @param p_tp      Pointer to receive the transport instance, if one is found.
+ *
+ * @return          PJ_SUCCESS on success, or the appropriate error code.
  */
 PJ_DECL(pj_status_t) 
@@ -364 +374 @@
                                const pj_sockaddr_t *remote,
                                int addr_len,
-                               pjsip_transport **p_transport);
+                               const pjsip_tpselector *sel,
+                               pjsip_transport **p_tp);