Ignore:
Timestamp:
May 17, 2008 12:45:00 PM (11 years ago)
Author:
bennylp
Message:

Ticket #534: Client register/registration support for various registrar brokenness

File:
1 edited

Legend:

Unmodified
Added
Removed
  • pjproject/trunk/pjsip/include/pjsip-ua/sip_regc.h

    r1748 r1959  
    6363{ 
    6464    pjsip_regc          *regc;      /**< Client registration structure.     */ 
    65     void                *token;     /**< Arbitrary token.                   */ 
    66     pj_status_t          status;    /**< Error status.                      */ 
     65    void                *token;     /**< Arbitrary token set by application */ 
     66 
     67    /** Error status. If this value is non-PJ_SUCCESS, some error has occured. 
     68     *  Note that even when this contains PJ_SUCCESS the registration might 
     69     *  have failed; in this case the \a code field will contain non 
     70     *  successful (non-2xx status class) code 
     71     */ 
     72    pj_status_t          status; 
    6773    int                  code;      /**< SIP status code received.          */ 
    6874    pj_str_t             reason;    /**< SIP reason phrase received.        */ 
     
    296302 
    297303/** 
    298  * Update Contact details in the client registration structure. 
     304 * Update Contact details in the client registration structure. For each 
     305 * contact URI, if the uri is not found in existing contact, it will be 
     306 * added to the Contact list. If the URI matches existing contact, nothing 
     307 * will be added. This function will also mark existing contacts which 
     308 * are not specified in the new contact list as to be removed, by adding 
     309 * "expires=0" parameter to these contacts. 
     310 * 
     311 * Once the contact list has been updated, application must update the 
     312 * registration by creating a new REGISTER request and send it to the 
     313 * registrar. This request will contain both old and new contacts; the 
     314 * old contacts will have it's expires parameter set to zero to instruct 
     315 * the registrar to remove the bindings. 
    299316 * 
    300317 * @param regc      The client registration structure. 
    301318 * @param ccnt      Number of contacts. 
    302  * @param contact   Array of contacts. 
    303  * @return          zero if sucessfull. 
     319 * @param contact   Array of contact URIs. 
     320 * @return          PJ_SUCCESS if sucessfull. 
    304321 */ 
    305322PJ_DECL(pj_status_t) pjsip_regc_update_contact( pjsip_regc *regc, 
     
    308325 
    309326/** 
    310  * Update the expires value. 
     327 * Update the expires value. The next REGISTER request will contain 
     328 * new expires value for the registration. 
    311329 * 
    312330 * @param regc      The client registration structure. 
Note: See TracChangeset for help on using the changeset viewer.