Default constructor for the settings store.

Closes the connection to the host settings store and disposes of all open or used resources.

Creates and assigns the internal resources required by the data store library.

Creates a new host settings entry in the data store.

The index of the new entry is returned via the parameter aSettingsId.

The aSettings parameter contains the details of the new host entry. This parameter must be derived from TLbsHostSettingsBase and be compatible with entries in the data store. For SUPL related hosts, the aSettings parameter must be of type TLbsHostSettingsSupl.

Creating a new entry in the data store does not change the "default" host entry. If the application wishes to make the new entry the default host it must call SetDefaultHost() with the index of that entry.

Removes the host information with the specified ID from the data store.

If the specified host is currently defined as the default host no other host automatically becomes the new default. It is the responsibility of the calling application to select a new default host. This is done using the SetDefaultHostSettings() method.

Retrieves the settings for the host that is currently specified as the default host.

The default host is primarily used to decide which network server should be used to service terminal initiated location requests.

The default host is only changed by calling SetDefaultHostSettings().Adding or updating the settings for a host does not automatically make it the default.

SetDefaultHostSettings

Retrieves the settings for the host that is currently specified as the default host.

The default host is primarily used to decide which network server should be used to service terminal initiated location requests.

The default host is only changed by calling SetDefaultHostSettings().Adding or updating the settings for a host does not automatically make it the default.

SetDefaultHostSettings

Retrieves the settings for a particular host settings ID.

The host settings ID is a persistent identifier that uniquely specifies a host settings within one data store. This method locates and retrieves the settings for the host indicated by the parameter aSettingsId. If the method returns succcessfully, the paramter aSettings contains the details of the specified host.

The ID for a particular host settings can be retrieved by calling TLbsHostSettingsBase::HostSettingsId().

An application can monitor data store changes using the observer interface MLbsHostSettingsStoreObserver (passing it as parameter in CLbsHostSettingsStore::NewL()).

The parameter aSettings must be derived from TLbsHostSettingsBase. For SUPL related host information, the aSettings parameters must be of type TLbsHostSettingsSupl.

TLbsHostSettingsBase::HostSettingsId() TLbsHostSettingsSupl MLbsHostSettingsStoreObserver

Retrieves index of the next host settings following on from the specified host settings ID.

Used in conjunction with RewindHostSettings() this method allows a client application to iterate through the entire contents of the data store.

Before calling GetNextHostSettings() at the beginning of an iteration, the client application must call RewindHostSettings(). This resets the client's view of the data store. When the client subsequently calls GetNextHostSettings() the details of the first host settings will be returned.

To iterate through all host settings contained in the data store, the client application should continue to call GetNextHostSettings() until the method returns KErrNotFound. The method returns KErrNotFound if there are no further host settings contained in the data store.

NumHosts() TLbsHostSettingsSupl MLbsHostSettingsStoreObserver NewL()

Retrieves the ID and details of the next host settings (provisioned by the specified creator) in the data store

When a host setting is created, the client application specifies the ID of the type of "creator". This indicates (for example) if the settings was created by a control panel application or provisioned from the network.

Used in conjunction with RewindHostSettings(), a client application can use GetNextHostSettingsByCreator() to retrieve one or more host settings based on the ID of their creator.

To iterate through all host settings contained in the data store, the client application should continue to call GetNextHostSettingsByCreator() until the method returns KErrNotFound. The method returns KErrNotFound when there are no further host settings contained in the data store.

NumHosts() TLbsHostSettingsSupl MLbsHostSettingsStoreObserver NewL()

Creates a new connection to the host settings stored for the specified settings store ID. Each ID defines

Creates a new connection to the host settings stored for the specified protocol. By specifying an observer, the calling application will receive a notification whenever the specified store is updated by another client.

Note: The client application will not receive an update notification for changes made by itself.

Resets the client's view of the data store.

RewindHostSettings() is used in conjunction with GetNextHostSettings() and GetNextHostSettingsByCreator().

Before calling GetNextHostSettings() or GetNextHostSettingsByCreator() for the first time, the client application must call RewindHostSettings(). This resets the client's view of the data store. When a client subsequently calls GetNextHostSettings() or GetNextHostSettingsByCreator() the details of the first host settings will be returned.

GetNextHostSettings() GetNextHostSettingsByCreator()

Changes the default host to that specified by the supplied ID.

The default host is primarily used to decide which network server should be used to service terminal initiated location requests.

Replaces the settings for an existing host settings entry in the data store.

Note: The data in the parameter aSettings must have been initially obtained by calling GetHostSettings() on the same data store. For SUPL related hosts, the aSettings parameters must be of type TLbsHostSettingsSupl.

Updating an entry does not change the default host for the particular data store. If the application wishes to make the updated entry the default host, it must call SetDefaultHost() with the index of that entry.

In order to maintain two implementations behind one interface we are holding two different versions of the implementation. The pointer to the C class will only be used for instantiation and destruction, we shall use the pointer to the mixin for everything else.