C++ default constructor.

Destructor.

This method is used to add new server into settings. It is client's responsibility to set all the parameters in aParamValues except SLP identification. After adding server entry, the server identity generated will be retuned with aSlpId. The returned server identity can be used with other methods change any of server parameters. If server entry with the same server address already presnt, then this method returns error.

This method is invoked to cancel CSuplSettings::Initialize() .

This method changes the priority of the server to the specified priority. Here the priority refers to the order of server entries in the SUPL settings storage. If the priority of server is changed from position N to M and N > M, then the priority of all the server entries from Mth position will get. If the priority of server is changed from position N to M and N < M, then the priority of all servers from N+1 whill get changed. Priority is not valid if the mentioned priority specified beyond the number of number of servers already present in the settings. For example, if the specified priority is N and number of server entries in the settings in M, then N is invalid if N > M.

The parameter aDirection specifies whether the server to be moved up or down. If this has value ETrue server will be moved up. Else server will be moved down.

By default EPOC constructor is private.

This method can be used to generate HSLP address from the IMSI obtained during initialization. HSLP address in the FQDN format can have maximum size of 256 bytes. Client must allocate enough memory to hold the HSLP address. HSLP address can be generated from IMSI, for example, if HSLP address read from SUPL settings is empty or not valid. The generated HSLP is in the FQDN format and looks like "h-slp.mncXXX.mccYYY.3gppnetwork.org" where XXX and YYY values for MNC and MCC extracted from the IMSI.

This method should be invoked only after Initialize() is completed with KErrNone.

This synchronous method is used to retrieve properties of all servers from SUPL settings storage. This method retrieves all properties for each server.

This method is used to retrieve properties of all servers from SUPL settings storage. This method retrieves all properties for each server.

This method can be used to obtain the default IAP configured.

This method is used to retrieve all properties of default server from SUPL settings storage.

This method is used to retrieve parameter which indicates whether server details are editable or not.

This method retrieves the fallback value from SUPL settings storage.

This method is used to retrieve IAP Name in server parameters. IAP name refers to the access point which is used to access the HSLP over the internet. It is client's responsibility to allocate memory for IAP name before invoking this method.

This method returns IMSI obtained during initialization of SUPL settings object. This method should be invoked after Initialize() is completed with KErrNone.

This method is used to retrieve server address parameter from server settings. Client has to allocate memory for server address parameter.

This method is used to retrieve parameter which indicates whether server can be used for SUPL session or not.

This method is used to retrieve parameter which indicates whether server details can be removed if SIM is changed.

This method is used to retrieve all properties of server from SUPL settings storage based on SLP address.

This method is used to retrieve all properties of server from SUPL settings storage based on SLP identification.

This method is used to retrieve SUPL usage from settings storage.

This method is used to retrieve properties of all active triggers.

This method is used to retrieve properties of a given session trigger.

This method is used to retrieve parameter which indicates whether server can be used out side home network or not.

This method is invoked to initialize SUPL settings object. This is an asynchronous call and client can cancel this request by invoking CancelInitialize() . During initialization, current IMSI value is obtained from the system. Client should invoke this method to re-read the IMSI if the client detects an IMSI change.

Note that if Initialize() method is invoked after started listening to SUPL settings changes by invoking SetObserverL() , listening is not stopped.

This method compares IMSI value currently stored in SUPL settings storage with IMSI value obtained during initialization. If IMSI value obtained during initialization and IMSI value stored in SUPL settings storage are same, this method returns false otherwise true is returned. This method should be invoked after Initialize() is completed with KErrNone.

This method is used check whether server entry exists or not based on SLP identification

This method is used check whether server entry exists or not based on SLP address

Two-phased constructor.

Two-phased constructor.

This method is used to stop listening for SUPL setting changes. After removing observer, client has to free the memory allocated for the observer. If this method is invoked without setting observer using SetObserverL() method, the request is silently ignored.

This method is deletes server entry from SUPL settings storage.

This method is used to stop listening for SUPL session changes. After removing observer, client has to free the memory allocated for the observer. If this method is invoked without setting observer using SetSessionObserverL() method, the request is silently ignored.

This method is used to change all parameters of server in SUPL settings. The server identity in CServerParams which is passed as parameter gives information on for which server entry the values needs to be changed. If the passed server identity does not exists in settings, error is returned.

This method is used to change all parameters of default server in SUPL settings. In this method server identity of CServerParams passed is not considered and values of default server is updated except server identity. If none of the server is set as default, the new server entry will be added and will be marked as default. Client can use GetDefaultSlpId() method to get SLP identity of default server entry.

This method is used to change parameter which indicates whether server details are editable or not.

This method enables or disables the fall back in SUPL settings. If the fallback enabled, if the SUPL session fails with default server or with the sever mentioned then fallback will happen to next server in the list or to the server address generated from IMSI depending on the failure type. If the SUPL session has failed due to connection problem with server, then fallback will happen to the address generated from IMSI. In all other failures, fallback will happen to the next server in the list.

This method is used to change IAP Name in server parameters. IAP name refers to the access point which is used to access the HSLP over the internet.

This method is used to start listening for SUPL setting changes. To listen for changes, the client must implement the MSuplSettingsObserver interface. Client must allocated memory for the observer.

Listening can be stopped by invoking RemoveObserver() .

This method is used to change server address parameter in server settings

This method is used to change parameter which indicates whether server can be used for SUPL session or not.

This method is used to start listening for SUPL session changes. To listen for changes, the client must implement the MSuplSessionObserver interface. Client must allocated memory for the observer.

Listening can be stopped by invoking RemoveSessionObserver() .

This method is used to change parameter which indicates whether server details can be removed if SIM is changed.

This method is used to change SUPL usage. Using this method, SUPL usage can be set to any of the values specified in the enumeration TSuplSettingsUsage By default, SUPL usage will be set to always ask.

This method is used to change parameter which indicates whether server can be used out side home network or not.

This method is used to retrieve number of server entries present in SUPL settings.

Enumeration to indicate SUPL usage. This is used as parameter for SetSuplUsage() method. Client has to select one of the values from this enumeration when changing SUPL usage. For example, if client is changing SUPL usage to "always ask", it should select ESuplUsageAlwaysAsk. If SUPL usage is set to ESuplUsageDisabled, SUPL cannot be used.

Client can get SUPL usage using GetSuplUsage() method.

To store whether settings are locked or not

Pointer to CSuplSettingsEngine to all settings functions

Pointer to notifiers, needed to listen to SUPL settings change events

To store and retun status for Initialize method