Changeset 4037 for pjproject/branches/1.x/pjsip/include/pjsip-ua/sip_regc.h

Timestamp:

Apr 11, 2012 9:41:25 AM (12 years ago)

Author:

bennylp

Message:

More re #1481: Destroying the regc may lead to dangling binding in the register, so instead of destroying the regc, instruct it to release the transport instead

File:

• pjproject/branches/1.x/pjsip/include/pjsip-ua/sip_regc.h (modified) (1 diff)

pjproject/branches/1.x/pjsip/include/pjsip-ua/sip_regc.h

@@ -266 +266 @@
                                               const pjsip_tpselector *sel);
 
+/**
+ * Release the reference to current transport being used by the regc, if any.
+ * The regc keeps the reference to the last transport being used in order
+ * to prevent it from being destroyed. In some situation however, such as
+ * when the transport is disconnected, it is necessary to instruct the
+ * regc to release this reference so that the transport can be destroyed.
+ * See https://trac.pjsip.org/repos/ticket/1481 for background info.
+ *
+ * @param regc      The client registration instance.
+ *
+ * @return          PJ_SUCCESS on success, or the appropriate error code.
+ */
+PJ_DECL(pj_status_t) pjsip_regc_release_transport(pjsip_regc *regc);
 
 /**