Changeset 283 for pjproject/trunk/pjsip/include/pjsip-simple/presence.h

Timestamp:

Mar 5, 2006 11:53:36 AM (18 years ago)

Author:

bennylp

Message:

Added API to terminate dialog prematurely. Affect: dialog, invite sessions, evsub, and presence

File:

• pjproject/trunk/pjsip/include/pjsip-simple/presence.h (modified) (1 diff)

pjproject/trunk/pjsip/include/pjsip-simple/presence.h

@@ -127 +127 @@
                                             pjsip_rx_data *rdata,
                                             pjsip_evsub **p_evsub );
+
+
+/**
+ * Forcefully destroy the presence subscription. This function should only
+ * be called on special condition, such as when the subscription 
+ * initialization has failed. For other conditions, application MUST terminate
+ * the subscription by sending the appropriate un(SUBSCRIBE) or NOTIFY.
+ *
+ * @param sub           The presence subscription.
+ * @param notify        Specify whether the state notification callback
+ *                      should be called.
+ *
+ * @return              PJ_SUCCESS if subscription session has been destroyed.
+ */
+PJ_DECL(pj_status_t) pjsip_pres_terminate( pjsip_evsub *sub,
+                                           pj_bool_t notify );
+