TLbsExternalRequestInfo2 Class Reference

class TLbsExternalRequestInfo2 : public TLbsExternalRequestInfo

This class contains information about the external location requester when a location request is received from the network (MT-LR).

This class extends the TLbsExternalRequestInfo class to allow for longer Requester Id and Client Name strings.

It is backward compatible with the TLbsExternalRequestInfo class. Applications that can handle only the TLbsExternalRequestInfo class, may still access the information, but the length of the strings is limitted by the size of the buffers defined in the TLbsExternalRequestInfo class.

Unlike in the TLbsExternalRequestInfo class, only unicode (UCS2) strings are supported.

Because of a significant size it should be considered to store objects defined by this class on heap rather than on stack.

The length of the buffers defined in the TLbsExternalRequestInfo class is enough to store the Requestor Id and the LCS Client Name strings used by the RRC, RRLP and SUPL protocols. Use the TLbsExternalRequestInfo class instead.

Inherits from

Public Member Functions
TLbsExternalRequestInfo2 ()
IMPORT_C void GetClientName ( TDes16 &)
IMPORT_C void GetRequesterId ( TDes16 &)
IMPORT_C void SetClientName (const TDesC16 &)
IMPORT_C void SetRequesterId (const TDesC16 &)
Protected Member Functions
IMPORT_C TCodingScheme ClientNameCodingScheme ()
IMPORT_C TCodingScheme RequesterIdCodingScheme ()
IMPORT_C void SetClientNameCodingScheme (const TCodingScheme )
IMPORT_C void SetRequesterIdCodingScheme (const TCodingScheme )
Inherited Functions
TLbsExternalRequestInfo::ClientNameFormat()const
TLbsExternalRequestInfo::GetClientExternalId(TDes8 &)const
TLbsExternalRequestInfo::GetClientName(TDes8 &)const
TLbsExternalRequestInfo::GetRequesterId(TDes8 &)const
TLbsExternalRequestInfo::NetworkType()const
TLbsExternalRequestInfo::RequestSource()const
TLbsExternalRequestInfo::RequestType()const
TLbsExternalRequestInfo::RequesterIdFormat()const
TLbsExternalRequestInfo::SetClientExternalId(const TDesC8 &)
TLbsExternalRequestInfo::SetClientName(const TDesC8 &)
TLbsExternalRequestInfo::SetClientNameFormat(const TFormatIndicator)
TLbsExternalRequestInfo::SetNetworkType(const TNetworkType)
TLbsExternalRequestInfo::SetRequestSource(const TRequestSource)
TLbsExternalRequestInfo::SetRequestType(const TRequestType)
TLbsExternalRequestInfo::SetRequesterId(const TDesC8 &)
TLbsExternalRequestInfo::SetRequesterIdFormat(const TFormatIndicator)
TLbsExternalRequestInfo::TLbsExternalRequestInfo()
TLbsLocClassTypeBase::ClassSize()const
TLbsLocClassTypeBase::ClassType()const
TLbsLocClassTypeBase::TLbsLocClassTypeBase()
Inherited Enumerations
TLbsExternalRequestInfo:_TCodingScheme
TLbsExternalRequestInfo:_TFormatIndicator
TLbsExternalRequestInfo:_TNetworkType
TLbsExternalRequestInfo:_TRequestSource
TLbsExternalRequestInfo:_TRequestType
Private Attributes
TBuf16 < KLbsMaxClientNameSizeExt2 > iClientNameExt
TBuf16 < KLbsMaxRequesterIdSizeExt2 > iRequesterIdExt
TUint8 iReserved2
Inherited Attributes
TLbsLocClassTypeBase::iClassSize
TLbsLocClassTypeBase::iClassType

Constructor & Destructor Documentation

TLbsExternalRequestInfo2()

IMPORT_C TLbsExternalRequestInfo2 ( )

Constructor for TLbsExternalRequestInfo2 .

Member Functions Documentation

ClientNameCodingScheme()

IMPORT_C TCodingScheme ClientNameCodingScheme ( ) const [protected]

Get the client name coding scheme.

GetClientName(TDes16 &)

IMPORT_C void GetClientName ( TDes16 & aClientName ) const

Get the client name as a unicode string.

Parameters

TDes16 & aClientName Reference to a descriptor which Client Name is copied into.

GetRequesterId(TDes16 &)

IMPORT_C void GetRequesterId ( TDes16 & aRequesterId ) const

Get the requester Id as a unicode string.

Parameters

TDes16 & aRequesterId Reference to a descriptor which Requester Id is copied into.

RequesterIdCodingScheme()

IMPORT_C TCodingScheme RequesterIdCodingScheme ( ) const [protected]

Get the requester id coding scheme.

SetClientName(const TDesC16 &)

IMPORT_C void SetClientName ( const TDesC16 & aClientName )

Set the client name as a unicode string. Applications that cannot handle the extended TLbsExternalRequestInfo2 class can access the initial KLbsMaxClientNameSize/2 characters of the string through the TLbsExternalRequestInfo class.

Parameters

const TDesC16 & aClientName Reference to a descriptor that contains the client name.

SetClientNameCodingScheme(const TCodingScheme)

IMPORT_C void SetClientNameCodingScheme ( const TCodingScheme aCoding ) [protected]

Set the client name coding scheme.

Parameters

const TCodingScheme aCoding The client name coding scheme.

SetRequesterId(const TDesC16 &)

IMPORT_C void SetRequesterId ( const TDesC16 & aRequesterId )

Set the requester Id as a unicode string. Applications that cannot handle the extended TLbsExternalRequestInfo2 class can access the initial KLbsMaxRequesterIdSize/2 characters of the string through the TLbsExternalRequestInfo class.

Parameters

const TDesC16 & aRequesterId Reference to a descriptor that contains the requester Id.

SetRequesterIdCodingScheme(const TCodingScheme)

IMPORT_C void SetRequesterIdCodingScheme ( const TCodingScheme aCoding ) [protected]

Set the requester id coding scheme.

Parameters

const TCodingScheme aCoding The requester id coding scheme.

Member Data Documentation

TBuf16< KLbsMaxClientNameSizeExt2 > iClientNameExt

TBuf16 < KLbsMaxClientNameSizeExt2 > iClientNameExt [private]

TBuf16< KLbsMaxRequesterIdSizeExt2 > iRequesterIdExt

TBuf16 < KLbsMaxRequesterIdSizeExt2 > iRequesterIdExt [private]

TUint8 iReserved2

TUint8 iReserved2 [private]