35 save the profile when the values are set. </p> </li> |
35 save the profile when the values are set. </p> </li> |
36 <li id="GUID-1B40AA8E-6326-5631-B83E-5230192FBC0E"><p>When you call <xref href="GUID-475D1AF4-F8C2-3243-99DC-43419979A858.dita"><apiname>SaveL()</apiname></xref>, |
36 <li id="GUID-1B40AA8E-6326-5631-B83E-5230192FBC0E"><p>When you call <xref href="GUID-475D1AF4-F8C2-3243-99DC-43419979A858.dita"><apiname>SaveL()</apiname></xref>, |
37 wait until <xref href="GUID-92312598-A5DA-36B9-AF46-E7EE80452792.dita"><apiname>EProfileCreated</apiname></xref> event is reported in the observer. |
37 wait until <xref href="GUID-92312598-A5DA-36B9-AF46-E7EE80452792.dita"><apiname>EProfileCreated</apiname></xref> event is reported in the observer. |
38 When the event is received the profile is created. </p> </li> |
38 When the event is received the profile is created. </p> </li> |
39 </ol> <fig id="GUID-13F7B1AB-7F1A-544F-AC9C-26780E4FC517"> |
39 </ol> <fig id="GUID-13F7B1AB-7F1A-544F-AC9C-26780E4FC517"> |
40 <image href="GUID-46A91D57-7864-53AD-903C-B978B0C61DAD_d0e342329_href.jpg" placement="inline"/> |
40 <image href="GUID-46A91D57-7864-53AD-903C-B978B0C61DAD_d0e336132_href.jpg" placement="inline"/> |
41 </fig> <p>The following code snippet shows how to create and save a profile. </p> <codeblock id="GUID-EFDEE0D4-00C9-520E-B1FA-18E48702DE7F" xml:space="preserve">/*Client must create an instance of the CSIP class. The API used for this is, here TUid must be an application UID.*/ |
41 </fig> <p>The following code snippet shows how to create and save a profile. </p> <codeblock id="GUID-EFDEE0D4-00C9-520E-B1FA-18E48702DE7F" xml:space="preserve">/*Client must create an instance of the CSIP class. The API used for this is, here TUid must be an application UID.*/ |
42 |
42 |
43 CSIP* CSIP::NewL(const TUid& aUid, MSIPObserver& aObserver); |
43 CSIP* CSIP::NewL(const TUid& aUid, MSIPObserver& aObserver); |
44 |
44 |
45 /* CSIPManagedProfileRegistry manages SIP profiles and provides functions for adding, updating, or removing profiles at run time. */ |
45 /* CSIPManagedProfileRegistry manages SIP profiles and provides functions for adding, updating, or removing profiles at run time. */ |
109 the profile status after the <xref href="GUID-93D33C84-8A6B-3A94-9797-1412489323F0.dita"><apiname>EnableL</apiname></xref> function is called. |
109 the profile status after the <xref href="GUID-93D33C84-8A6B-3A94-9797-1412489323F0.dita"><apiname>EnableL</apiname></xref> function is called. |
110 If the profile is not registered after this function is called, the user must |
110 If the profile is not registered after this function is called, the user must |
111 wait until it gets a notification through the <xref href="GUID-91663686-42B7-3C88-B773-3C5343CDCFCE.dita"><apiname>MSIPProfileRegistryObserver</apiname></xref> callback |
111 wait until it gets a notification through the <xref href="GUID-91663686-42B7-3C88-B773-3C5343CDCFCE.dita"><apiname>MSIPProfileRegistryObserver</apiname></xref> callback |
112 interface about the profile registration. </p> </li> |
112 interface about the profile registration. </p> </li> |
113 </ol> <fig id="GUID-9300C461-D490-5E0B-84A6-AD40F95B8DE7"> |
113 </ol> <fig id="GUID-9300C461-D490-5E0B-84A6-AD40F95B8DE7"> |
114 <image href="GUID-5C52B6B9-546C-5152-A968-B91CB3D885A0_d0e342464_href.jpg" placement="inline"/> |
114 <image href="GUID-5C52B6B9-546C-5152-A968-B91CB3D885A0_d0e336267_href.jpg" placement="inline"/> |
115 </fig> <p>The following code snippet shows how to enable a SIP profile. </p> <codeblock id="GUID-1A52EE02-D6E9-5795-995B-6B5ADFD131B4" xml:space="preserve"> |
115 </fig> <p>The following code snippet shows how to enable a SIP profile. </p> <codeblock id="GUID-1A52EE02-D6E9-5795-995B-6B5ADFD131B4" xml:space="preserve"> |
116 /*With the assumption that the profile was created and is saved to the persistent storage. */ |
116 /*With the assumption that the profile was created and is saved to the persistent storage. */ |
117 //Create an Instance of SIP client |
117 //Create an Instance of SIP client |
118 |
118 |
119 iSip = CSIP::NewL( aAppUid ); |
119 iSip = CSIP::NewL( aAppUid ); |
331 <li id="GUID-9CA4CA87-17C7-54D0-AEAF-F415DA5D934E"><p>A REGISTER request sent |
331 <li id="GUID-9CA4CA87-17C7-54D0-AEAF-F415DA5D934E"><p>A REGISTER request sent |
332 to the registrar server. </p> </li> |
332 to the registrar server. </p> </li> |
333 <li id="GUID-FF40934C-588D-5ED6-8041-410103FB6D53"><p>The registration status |
333 <li id="GUID-FF40934C-588D-5ED6-8041-410103FB6D53"><p>The registration status |
334 of the profile is set to Registered. </p> </li> |
334 of the profile is set to Registered. </p> </li> |
335 </ul> <p>The following sequence diagram shows how to enable a profile to refresh. </p> <fig id="GUID-5EF1953C-E56D-59C2-B443-F1B77DD7E73D"> |
335 </ul> <p>The following sequence diagram shows how to enable a profile to refresh. </p> <fig id="GUID-5EF1953C-E56D-59C2-B443-F1B77DD7E73D"> |
336 <image href="GUID-8D9FE811-3F8A-5C2A-B76A-5C0248179590_d0e342779_href.jpg" placement="inline"/> |
336 <image href="GUID-8D9FE811-3F8A-5C2A-B76A-5C0248179590_d0e336582_href.jpg" placement="inline"/> |
337 </fig> <p>The following code describes how to refresh enable a profile. </p> <codeblock id="GUID-1A13F3D3-C4B7-50E5-B5AF-F0CABF02758C" xml:space="preserve">//Checks if the profile is already enabled and requests the Profile Agent to refresh it. |
337 </fig> <p>The following code describes how to refresh enable a profile. </p> <codeblock id="GUID-1A13F3D3-C4B7-50E5-B5AF-F0CABF02758C" xml:space="preserve">//Checks if the profile is already enabled and requests the Profile Agent to refresh it. |
338 // If the profile is not enabled it leaves with KErrArgument. |
338 // If the profile is not enabled it leaves with KErrArgument. |
339 |
339 |
340 void RefreshEnableL(CSIPProfile& aSIPProfile, MSIPConnectionObserver& aObserver) |
340 void RefreshEnableL(CSIPProfile& aSIPProfile, MSIPConnectionObserver& aObserver) |
341 </codeblock> </section> |
341 </codeblock> </section> |