Changeset 3196 for pjproject/trunk/pjsip/include/pjsua-lib/pjsua.h

Timestamp:

Jun 3, 2010 10:41:32 AM (14 years ago)

Author:

nanang

Message:

Re #1089:

• Added a feature in dialog to store and retrieve remote capabilities dug from the remote messages.
• Added few APIs in dialog to query and update remote capabilities, also added an API in pjsua_call to query whether a capability is supported by remote.

File:

• pjproject/trunk/pjsip/include/pjsua-lib/pjsua.h (modified) (1 diff)

pjproject/trunk/pjsip/include/pjsua-lib/pjsua.h

@@ -2821 +2821 @@
                                          pjsua_call_info *info);
 
+/**
+ * Check if remote peer support the specified capability.
+ *
+ * @param call_id       Call identification.
+ * @param htype         The header type to be checked, which value may be:
+ *                      - PJSIP_H_ACCEPT
+ *                      - PJSIP_H_ALLOW
+ *                      - PJSIP_H_SUPPORTED
+ * @param hname         If htype specifies PJSIP_H_OTHER, then the header
+ *                      name must be supplied in this argument. Otherwise the 
+ *                      value must be set to NULL.
+ * @param token         The capability token to check. For example, if \a 
+ *                      htype is PJSIP_H_ALLOW, then \a token specifies the 
+ *                      method names; if \a htype is PJSIP_H_SUPPORTED, then
+ *                      \a token specifies the extension names such as
+ *                       "100rel".
+ *
+ * @return              PJSIP_DIALOG_CAP_SUPPORTED if the specified capability
+ *                      is explicitly supported, see @pjsip_dialog_cap_status
+ *                      for more info.
+ */
+PJ_DECL(pjsip_dialog_cap_status) pjsua_call_remote_has_cap(
+                                                    pjsua_call_id call_id,
+                                                    int htype,
+                                                    const pj_str_t *hname,
+                                                    const pj_str_t *token);
 
 /**