Symbian^3 Product Developer Library >

CRequestorBase Class Reference

class CRequestorBase : public CBase
Each instance of a CRequestor class is used to hold the identity of one of the parties involved requesting the location. The class contains three data fields that indicate: (1) If the requesting party is a "service" or an actual person ("contact"). (2) A descriptor that identifiers the requestor and (3) a field that indicates which format the information is in

  • for example, a telephone number, URL or email address.

Inherits from

Public Member Functions
~CRequestorBase()
IMPORT_C voidExternalizeL(RWriteStream &)
IMPORT_C voidGetRequestor(TRequestorType &, TRequestorFormat &, TPtrC &)
IMPORT_C voidInternalizeL(RReadStream &)
IMPORT_C TDesC &RequestorData()
IMPORT_C TRequestorFormatRequestorFormat()
IMPORT_C TRequestorTypeRequestorType()
IMPORT_C voidSetRequestorL(TRequestorType, TRequestorFormat, const TDesC &)
Protected Member Functions
CRequestorBase()
IMPORT_C voidConstructL(TRequestorType, TRequestorFormat, const TDesC &)
IMPORT_C TAny *ExtendedInterface(TInt, TAny *, TAny *)
Inherited Functions
CBase::CBase()
CBase::Delete(CBase *)
CBase::Extension_(TUint,TAny *&,TAny *)
CBase::operator new(TUint)
CBase::operator new(TUint,TAny *)
CBase::operator new(TUint,TLeave)
CBase::operator new(TUint,TLeave,TUint)
CBase::operator new(TUint,TUint)
CBase::~CBase()
Public Member Enumerations
enum_TRequestorFormat { EFormatUnknown, EFormatApplication, EFormatTelephone, EFormatUrl, EFormatMail }
enum_TRequestorType { ERequestorUnknown, ERequestorService, ERequestorContact }
Public Member Type Definitions
typedef TInt TRequestorFormat
typedef TInt TRequestorType
Protected Attributes
TRequestorFormat iFormat
TRequestorType iRequestorType
Private Attributes
TAny *iBaseReservedPtr
HBufC *iData

Constructor & Destructor Documentation

CRequestorBase()

IMPORT_CCRequestorBase()[protected]

Constructor for CRequestorBase.

~CRequestorBase()

IMPORT_C~CRequestorBase()

Destructor for CRequestorBase.

Member Functions Documentation

ConstructL(TRequestorType, TRequestorFormat, const TDesC &)

IMPORT_C voidConstructL(TRequestorTypeaType,
TRequestorFormataFormat,
const TDesC &aData
)[protected]

Second phase constructor. Must be called by all derived classes to initialise CRequestorBase.

Parameters

TRequestorType aTypeidentifies the type of requestor, a service or a contact.
TRequestorFormat aFormatdetermines the type of data held in aData
const TDesC & aDatais requestor data. Can be a telephone number, a URL etc.

ExtendedInterface(TInt, TAny *, TAny *)

IMPORT_C TAny *ExtendedInterface(TIntaFunctionNumber,
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 aFunctionNumbercontains the Id of the function to be invoked.
TAny * aPtr1a pointer to any data
TAny * aPtr2a pointer to any data.

ExternalizeL(RWriteStream &)

IMPORT_C voidExternalizeL(RWriteStream &aStream)const [virtual]

Stores this requestors member data to a stream.

Parameters

RWriteStream & aStreamthe stream to which the requestors data is written.

GetRequestor(TRequestorType &, TRequestorFormat &, TPtrC &)

IMPORT_C voidGetRequestor(TRequestorType &aType,
TRequestorFormat &aFormat,
TPtrC &aData
)const

Simple accessor for this requestors member data.

Parameters

TRequestorType & aTypewill be set to the type of requestor.
TRequestorFormat & aFormatwill be set to the type of data held in aData.
TPtrC & aDatawill be set to point to this requestors data.

InternalizeL(RReadStream &)

IMPORT_C voidInternalizeL(RReadStream &aStream)[virtual]

Restores this requestors member data from a stream.

Parameters

RReadStream & aStreamthe stream from which the requestors data is read.

RequestorData()

IMPORT_C TDesC &RequestorData()const

Simple accessor for this requestors member data.

RequestorFormat()

IMPORT_C TRequestorFormatRequestorFormat()const

Simple accessor for this requestors member data.

RequestorType()

IMPORT_C TRequestorTypeRequestorType()const

Simple accessor for this requestors member data.

SetRequestorL(TRequestorType, TRequestorFormat, const TDesC &)

IMPORT_C voidSetRequestorL(TRequestorTypeaType,
TRequestorFormataFormat,
const TDesC &aData
)

Replaces the requestor data for this object with the specified data.

Parameters

TRequestorType aTypeidentifies the type of requestor, a service or a contact.
TRequestorFormat aFormatdetermines the type of data held in aData
const TDesC & aDatais requestor data. Can be a telephone number, a URL etc.

Member Enumerations Documentation

Enum _TRequestorFormat

TRequestorFormat

Enumerators

EFormatUnknown

Requestor format unknown

EFormatApplication

EFormatApplication

EFormatTelephone

EFormatTelephone

EFormatUrl

EFormatUrl

EFormatMail

EFormatMail

Enum _TRequestorType

TRequestorType

Enumerators

ERequestorUnknown

Unknown Requestor

ERequestorService

Requestor of type Service

ERequestorContact

Requestor of type Contact

Member Type Definitions Documentation

Typedef TRequestorFormat

typedef TInt TRequestorFormat

defined type for TRequestorFormat

Typedef TRequestorType

typedef TInt TRequestorType

defined type for TRequestorType

Member Data Documentation

TAny * iBaseReservedPtr

TAny *iBaseReservedPtr[private]

Reserved data for future extension

HBufC * iData

HBufC *iData[private]

This is owned by the CRequestor

TRequestorFormat iFormat

TRequestorFormat iFormat[protected]

Requestor format

TRequestorType iRequestorType

TRequestorType iRequestorType[protected]

Requestor type

Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License v1.0.