MLbsLocationInfoConverterObserver Class Reference

#include <lbslocationinfoconverter.h>

List of all members.

Public Member Functions

virtual IMPORT_C TVersion Version () const
virtual void OnConversionComplete (TInt aStatusCode)=0

Detailed Description

The MLbsLocationInfoConverterObserver class is used in partnership with CLbsLocationInfoConverter. The observer interface is used by the LBS subsystem to inform a client application when a Locality conversion process initiated through the CLbsLocationInfoConverter class has been finished. In OnResolveLocationComplete the results will be returned as an argument of the function, while OnConversionComplete indicates that the results have been written in to the data that was passed in using ConvertLocationInfoL.

Although all the interface methods in the MLbsLocationInfoConverterObserver class are synchronous, the client application should ensure they return quickly (e.g. any extensive processing of the received data is scheduled in another active object).


Member Function Documentation

virtual void MLbsLocationInfoConverterObserver::OnConversionComplete ( TInt  aStatusCode  )  [pure virtual]

The callback is used by the LBS subsystem to inform a client application that a general purpose Locality conversion process initiated through the CLbsLocationInfoConverter::ConvertLocationInfoL method has been finished.

Receiving the callback indicates that, unless the conversion was not successful, the location data structures passed through the CLbsLocationInfoConverter::ConvertLocationInfoL method have been updated with the requested information.

Parameters:
aStatusCode Result of the conversion operation; KErrNone if at least one conversion have been successful and the related location data structure(s) passed through the CLbsLocationInfoConverter::ConvertLocationInfoL method have been updated with the requested information; KErrNotSupported if the conversion type specified by aRequestedInfo is not supported by converter plugin KErrNotFound if none of conversions have been successful; Or other system wide error code othervise. In here I think we should say that when the caller uses ConvertLocationInfoL( RLbsLocationInfoBaseArray& aLocationInfoArray, ..) then on OnConversionComplete the caller should iterate around all 'n' of the entries of the aLocationInfoArray and call GetAreaInfoL to see if there is any conversion results. OH I see below that you say something near the ConvertLocationInfoL method. Maybe should say it here as well to ti e together
EXPORT_C TVersion MLbsLocationInfoConverterObserver::Version (  )  const [virtual]

Gets the current version of the observer interface. Derived classes should not change the implementation.

Returns:
Version number (currently 1.0.0)

The documentation for this class was generated from the following files:

Copyright (c) 2005-2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. These materials are provided under the terms of the Eclipse Public License v1.0.