Changeset 797 for pjproject/trunk/pjsip/include/pjsip/sip_ua_layer.h

Timestamp:

Nov 11, 2006 4:16:04 PM (18 years ago)

Author:

bennylp

Message:

Attended call transfer implementation. The changes involves:

• Added support for SIP Replaces extension (RFC 3891)
• Added pjsua_call_xfer_replaces() to perform attended call transfer.
• PJSUA checks and process Replaces header in incoming calls
• Added pjsip_ua_find_dialog() API.
• Added pjsip_endpt_has_capability() API.
• Added pjsip_endpt_send_response2() API.
• etc.

File:

• pjproject/trunk/pjsip/include/pjsip/sip_ua_layer.h (modified) (1 diff)

pjproject/trunk/pjsip/include/pjsip/sip_ua_layer.h

@@ -82 +82 @@
 
 /**
+ * Find a dialog with the specified Call-ID and tags properties. This
+ * function may optionally lock the matching dialog instance before
+ * returning it back to the caller.
+ *
+ * @param call_id       The call ID to be matched.
+ * @param local_tag     The local tag to be matched.
+ * @param remote_tag    The remote tag to be matched.
+ * @param lock_dialog   If non-zero, instruct the function to lock the 
+ *                      matching dialog with #pjsip_dlg_inc_lock(). 
+ *                      Application is responsible to release the dialog's
+ *                      lock after it has finished manipulating the dialog,
+ *                      by calling #pjsip_dlg_dec_lock().
+ *
+ * @return              The matching dialog instance, or NULL if no matching
+ *                      dialog is found.
+ */
+PJ_DECL(pjsip_dialog*) pjsip_ua_find_dialog(const pj_str_t *call_id,
+                                            const pj_str_t *local_tag,
+                                            const pj_str_t *remote_tag,
+                                            pj_bool_t lock_dialog);
+
+/**
  * Destroy the user agent layer.
  *