#include <lbs.h>
Link against: lbs.lib
| class RPositionerSubSessionBase : public RSubSessionBase |
| Public Member Type Definitions | |
|---|---|
| typedef | TInt TRequestId |
| Public Member Enumerations | |
|---|---|
| enum | _TRequestId { EReqUnknown, EReqGetLastKnownPosition, EReqGetLastKnownPositionArea, EReqNotifyPositionUpdate } |
| Public Member Functions | |
|---|---|
| IMPORT_C TInt | CancelRequest(TRequestId) |
| IMPORT_C TInt | CompleteRequest(TInt) |
| Protected Member Functions | |
|---|---|
| RPositionerSubSessionBase() | |
| virtual IMPORT_C TAny * | ExtendedInterface(TInt, TAny *, TAny *) |
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.
See also: RPositioner
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.
| Enumerator | Value | Description |
|---|---|---|
| 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 |
| IMPORT_C | RPositionerSubSessionBase | ( | ) | [protected] |
Constructor for RPositionerSubSessionBase
| 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.
| Parameters | |
|---|---|
| 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() |
| Panic Codes | |
|---|---|
| "Lbs | Client Fault" 6 If no connection has been established with Location Server ( by calling |
| 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 | |
|---|---|
| aFunctionNumber | contains the Id of the function to be invoked. |
| aPtr1 | a pointer to any data |
| aPtr2 | a pointer to any data. |