Changeset 5969 for pjproject/trunk/pjsip/include/pjsua2/account.hpp

Timestamp:

Apr 15, 2019 10:52:16 AM (6 years ago)

Author:

nanang

Message:

Close #2189: fixed PJSUA2 thread safety issue in list of objects manipulation.

File:

• pjproject/trunk/pjsip/include/pjsua2/account.hpp (modified) (4 diffs)

pjproject/trunk/pjsip/include/pjsua2/account.hpp

@@ -1649 +1649 @@
      * and delete the corresponding account in the PJSUA-LIB.
      *
+     * Note that application must delete all Buddy instances belong to this
+     * account before shutting down the account.
+     *
      * If application implements a derived class, the derived class should
      * call this method in the beginning stage in its destructor, or
@@ -1760 +1763 @@
     
     /**
+     * Warning: deprecated, use enumBuddies2() instead. This function is not
+     * safe in multithreaded environment.
+     *
      * Enumerate all buddies of the account.
      *
@@ -1767 +1773 @@
 
     /**
+     * Enumerate all buddies of the account.
+     *
+     * @return                  The buddy list.
+     */
+    BuddyVector2 enumBuddies2() const throw(Error);
+
+    /**
+     * Warning: deprecated, use findBuddy2 instead. This function is not
+     * safe in multithreaded environment.
+     *
      * Find a buddy in the buddy list with the specified URI. 
      *
@@ -1778 +1794 @@
     Buddy* findBuddy(string uri, FindBuddyMatch *buddy_match = NULL) const
                     throw(Error);
+
+    /**
+     * Find a buddy in the buddy list with the specified URI. 
+     *
+     * Exception: if buddy is not found, PJ_ENOTFOUND will be thrown.
+     *
+     * @param uri               The buddy URI.
+     *
+     * @return                  The pointer to buddy.
+     */
+    Buddy findBuddy2(string uri) const throw(Error);
 
 public: