Using -URIs from the URI List

The URI List framework provides two classes for URI list operation: RInetUri and RInetUriList. RInetUri represents a handle to the URI and its associated properties (like service -type, list type, permission and favourite name). RInetUriList represents -a handle to the entire list and provides APIs for adding URIs to the list, -removing URIs from the list, and updating URIs in the list. Before performing -any operation, a session with URI List Server should be created by calling RInetUriList::OpenL().

This section contains the following subsections:

Adding a URI to the list
Removing a URI from the list
Updating a URI in the list

Adding a URI -to the list

A URI can be added to the list using the following -API:

void AddL(const RInetUri& aInetUri)

Where -the RInetUri parameter is the Uri property -object that contains all properties of a URI. Sample code to add URIs to the -list is shown here.

//Create the URI -_LIT8(KUri, “http://www.symbian.org”); - -//Create a RInetUri object -RInetUri uriObject; - -//Now initialise the object with Uri properties. - uriObject.CreateL ( KUri, EWapPush, EBlackList); - CleanupClosePushL(uriObject); - -//Now create the RInetUriList object - RInetUriList uriListObj; - -//Create a server session - uriListObj.OpenL(); - CleanupClosePushL(uriListObj); - -//Now add the Uri to list. - uriListObj.AddL(uriObject); - -//Pop and close the server session. -CleanupStack::PopAndDestroy ( &uriListObj); - -//Pop and free up memory of uri property object. -CleanupStack::PopAndDestroy ( &uriObject); -

The RInetUri::CreateL function accepts -a reference to an 8-bit descriptor only. By default, the permission attribute -of Uri is set to EReadWrite. RInetUri::Close should -be called to free up the memory.

Removing a -URI from the list

The RInetUriList class provides -the following API for removing a URI from the list:

void -RemoveL(const RInetUri& aInetUri)

Where the RInetUri parameter -is the Uri property object. This object handle can be obtained -by calling RInetUriList::OpenInetUriL(), and passing URI -and service type. Sample code to remove URIs from the list is shown here:

_LIT8(KUri “http://www.symbian.org”); - RInetUri uriObject; - RInetUriList uriListObj; - uriListObj.OpenL(); - CleanupClosePushL(uriListObj); - - uriObject = uriListObj. OpenInetUriL(KUri, EBrowser); - CleanupClosePushL(uriObject); - uriListObj.RemoveL(uriObject); - -//Pop and close the server session. -CleanupStack::PopAndDestroy ( &uriListObj); - -//Pop and free up memory of uri property object. -CleanupStack::PopAndDestroy ( &uriObject); -

Updating a -URI in the list

The RInetUriList class provides -the following API for updating properties of a URI in the list:

void -UpdateL(const RInetUri& aInetUri)

Where the RInetUri parameter -is the Uri property object. This object handle can be obtained -by calling RInetUriList::OpenInetUriL(), and passing URI -and service type. Only favourite name and list type of a URI -can be updated. Sample code to update a URI in the list is shown here.

_LIT8(KUri “http://www.symbian.org”); - _LIT8(KUriFavoritename “Home Page of Symbian”); - RInetUri uriObject; - RInetUriList uriListObj; - uriListObj.OpenL(); - CleanupClosePushL(uriListObj); - - uriObject = uriListObj. OpenInetUriL(KUri, EBrowser); - CleanupClosePushL(uriObject); - uriObject.SetListType(EBlackList); - uriObject.SetFavoriteNameL(KUriFavoritename); - uriListObj.UpdateL(uriObject); - -//Pop and close the server session. -CleanupStack::PopAndDestroy ( &uriListObj); - -//Pop and free up memory of uri property object. -CleanupStack::PopAndDestroy ( &uriObject); -

+ + + + + +Using +URIs from the URI List +

The URI List framework provides two classes for URI list operation: RInetUri and RInetUriList. RInetUri represents a handle to the URI and its associated properties (like service +type, list type, permission and favourite name). RInetUriList represents +a handle to the entire list and provides APIs for adding URIs to the list, +removing URIs from the list, and updating URIs in the list. Before performing +any operation, a session with URI List Server should be created by calling RInetUriList::OpenL().

This section contains the following subsections:

Adding a URI to the list
Removing a URI from the list
Updating a URI in the list

Adding a URI +to the list

A URI can be added to the list using the following +API:

void AddL(const RInetUri& aInetUri)

Where +the RInetUri parameter is the Uri property +object that contains all properties of a URI. Sample code to add URIs to the +list is shown here.

//Create the URI +_LIT8(KUri, “http://www.symbian.org”); + +//Create a RInetUri object +RInetUri uriObject; + +//Now initialise the object with Uri properties. + uriObject.CreateL ( KUri, EWapPush, EBlackList); + CleanupClosePushL(uriObject); + +//Now create the RInetUriList object + RInetUriList uriListObj; + +//Create a server session + uriListObj.OpenL(); + CleanupClosePushL(uriListObj); + +//Now add the Uri to list. + uriListObj.AddL(uriObject); + +//Pop and close the server session. +CleanupStack::PopAndDestroy ( &uriListObj); + +//Pop and free up memory of uri property object. +CleanupStack::PopAndDestroy ( &uriObject); +

The RInetUri::CreateL function accepts +a reference to an 8-bit descriptor only. By default, the permission attribute +of Uri is set to EReadWrite. RInetUri::Close should +be called to free up the memory.

Removing a +URI from the list

The RInetUriList class provides +the following API for removing a URI from the list:

void +RemoveL(const RInetUri& aInetUri)

Where the RInetUri parameter +is the Uri property object. This object handle can be obtained +by calling RInetUriList::OpenInetUriL(), and passing URI +and service type. Sample code to remove URIs from the list is shown here:

_LIT8(KUri “http://www.symbian.org”); + RInetUri uriObject; + RInetUriList uriListObj; + uriListObj.OpenL(); + CleanupClosePushL(uriListObj); + + uriObject = uriListObj. OpenInetUriL(KUri, EBrowser); + CleanupClosePushL(uriObject); + uriListObj.RemoveL(uriObject); + +//Pop and close the server session. +CleanupStack::PopAndDestroy ( &uriListObj); + +//Pop and free up memory of uri property object. +CleanupStack::PopAndDestroy ( &uriObject); +

Updating a +URI in the list

The RInetUriList class provides +the following API for updating properties of a URI in the list:

void +UpdateL(const RInetUri& aInetUri)

Where the RInetUri parameter +is the Uri property object. This object handle can be obtained +by calling RInetUriList::OpenInetUriL(), and passing URI +and service type. Only favourite name and list type of a URI +can be updated. Sample code to update a URI in the list is shown here.

_LIT8(KUri “http://www.symbian.org”); + _LIT8(KUriFavoritename “Home Page of Symbian”); + RInetUri uriObject; + RInetUriList uriListObj; + uriListObj.OpenL(); + CleanupClosePushL(uriListObj); + + uriObject = uriListObj. OpenInetUriL(KUri, EBrowser); + CleanupClosePushL(uriObject); + uriObject.SetListType(EBlackList); + uriObject.SetFavoriteNameL(KUriFavoritename); + uriListObj.UpdateL(uriObject); + +//Pop and close the server session. +CleanupStack::PopAndDestroy ( &uriListObj); + +//Pop and free up memory of uri property object. +CleanupStack::PopAndDestroy ( &uriObject); +

\ No newline at end of file