RPositionerSubSessionBase Class Reference

class RPositionerSubSessionBase : public RSubSessionBase

Abstract base class for all positioning sub-sessions, including RPositioner .

Asynchronous requests issued from derived classess are cancelled using the method CancelRequest() with a value from the enumeration _TReqestId corresponding to the particular operation being cancelled.

RPositioner

Inherits from

Constructor & Destructor Documentation

RPositionerSubSessionBase()

IMPORT_C RPositionerSubSessionBase ( ) [protected]

Member Functions Documentation

CancelRequest(TRequestId)

IMPORT_C TInt CancelRequest ( TRequestId aRequestId )

Cancels a previously issued asynchronous request. The TRequestStatus of the original request will be set to KErrCancel if the cancellation request was successful, or any other Symbian OS error code if CancelRequest was called too late.

panic
"Lbs Client Fault" 6 If no connection has been established with Location Server ( by calling RPositionServer::Connect() ).

Parameters

TRequestId aRequestId is a number that specifies the request to be cancelled. It should be set toEPositionerNotifyPositionUpdate to cancel a call to RPositioner::NotifyPositionUpdate().EPositionerGetLastKnownPosition to cancel a call to RPositioner::GetLastKnownPosition()

CompleteRequest(TInt)

IMPORT_C TInt CompleteRequest ( TInt aRequestId )

Parameters

TInt aRequestId

ExtendedInterface(TInt, TAny *, TAny *)

IMPORT_C TAny * ExtendedInterface ( TInt aFunctionNumber,
TAny * aPtr1,
TAny * aPtr2
) [protected, virtual]

This method is used to allow polymorphic extensions to the API without breaking BC. See documentation for explanation.

Parameters

TInt aFunctionNumber contains the Id of the function to be invoked.
TAny * aPtr1 a pointer to any data
TAny * aPtr2 a pointer to any data.

Member Enumerations Documentation

Enum _TRequestId

Identification numbers used for cancelling requests. Note that the TRequestId enum may be extended in the future by adding more enumerated values. To maintain compatibility any unrecognized values must be handled as EReqUnknown.

Enumerators

EReqUnknown = 0

Unknown/undefined Id

EReqGetLastKnownPosition = 1

The id of the GetLastKnownPosition request

EReqGetLastKnownPositionArea = 2

The id of the GetLastKnownPositionArea request

EReqNotifyPositionUpdate = 3

The id of the ReqNotifyPositionUpdate request

Member Type Definitions Documentation

Typedef TRequestId

typedef TInt TRequestId

Type for values defined in _TRequestId

Member Data Documentation

TAny * iReserved

TAny * iReserved [private]

Unused variable for future expansion.