RMobileNamStore Class Reference

class RMobileNamStore : public RMobilePhoneStore

Provides client access to NAM storage functionality provided by TSY

9.5

Public Member Functions
RMobileNamStore ()
IMPORT_C void Close ()
IMPORT_C TInt Open ( RMobilePhone &)
IMPORT_C void SetActiveNam ( TRequestStatus &, TInt )
IMPORT_C void StoreAllL ( TRequestStatus &, TInt , CMobilePhoneNamList *)
IMPORT_C void StoreAllL ( TRequestStatus &, TInt , CMobilePhoneNamListV4 *)
Protected Member Functions
IMPORT_C void ConstructL ()
Private Member Functions
RMobileNamStore (const RMobileNamStore &)
Inherited Functions
RMobilePhoneStore::BaseConstruct(CMobilePhoneStorePtrHolder *)
RMobilePhoneStore::Delete(TRequestStatus &,TInt)const
RMobilePhoneStore::DeleteAll(TRequestStatus &)const
RMobilePhoneStore::Destruct()
RMobilePhoneStore::GetInfo(TRequestStatus &,TDes8 &)const
RMobilePhoneStore::NotifyStoreEvent(TRequestStatus &,TUint32 &,TInt &)const
RMobilePhoneStore::RMobilePhoneStore()
RMobilePhoneStore::Read(TRequestStatus &,TDes8 &)const
RMobilePhoneStore::Write(TRequestStatus &,TDes8 &)const
RSubSessionBase::CloseSubSession(TInt)
RSubSessionBase::CreateAutoCloseSubSession(RSessionBase &,TInt,const TIpcArgs &)
RSubSessionBase::CreateSubSession(const RSessionBase &,TInt)
RSubSessionBase::CreateSubSession(const RSessionBase &,TInt,const TIpcArgs &)
RSubSessionBase::RSubSessionBase()
RSubSessionBase::Send(TInt)const
RSubSessionBase::Send(TInt,const TIpcArgs &)const
RSubSessionBase::SendReceive(TInt)const
RSubSessionBase::SendReceive(TInt,TRequestStatus &)const
RSubSessionBase::SendReceive(TInt,const TIpcArgs &)const
RSubSessionBase::SendReceive(TInt,const TIpcArgs &,TRequestStatus &)const
RSubSessionBase::Session()const
RSubSessionBase::SubSessionHandle()const
RTelSubSessionBase::Blank(const TInt,TReqPriorityType)const
RTelSubSessionBase::Blank(const TInt,TRequestStatus &,TReqPriorityType)const
RTelSubSessionBase::CancelAsyncRequest(TInt)const
RTelSubSessionBase::CancelReq(const TInt,const TInt)const
RTelSubSessionBase::CancelSubSession()const
RTelSubSessionBase::Get(const TInt,TDes16 &,TDes16 &,TReqPriorityType)const
RTelSubSessionBase::Get(const TInt,TDes16 &,TReqPriorityType)const
RTelSubSessionBase::Get(const TInt,TDes8 &,TDes16 &,TReqPriorityType)const
RTelSubSessionBase::Get(const TInt,TDes8 &,TDes8 &,TReqPriorityType)const
RTelSubSessionBase::Get(const TInt,TDes8 &,TReqPriorityType)const
RTelSubSessionBase::Get(const TInt,TRequestStatus &,TDes16 &,TDes16 &,TReqPriorityType)const
RTelSubSessionBase::Get(const TInt,TRequestStatus &,TDes16 &,TReqPriorityType)const
RTelSubSessionBase::Get(const TInt,TRequestStatus &,TDes8 &,TDes16 &,TReqPriorityType)const
RTelSubSessionBase::Get(const TInt,TRequestStatus &,TDes8 &,TDes8 &,TReqPriorityType)const
RTelSubSessionBase::Get(const TInt,TRequestStatus &,TDes8 &,TReqPriorityType)const
RTelSubSessionBase::RTelSubSessionBase()
RTelSubSessionBase::ResetSessionHandle()
RTelSubSessionBase::SessionHandle()const
RTelSubSessionBase::Set(const TInt,TRequestStatus &,const TDesC16 &,TReqPriorityType)const
RTelSubSessionBase::Set(const TInt,TRequestStatus &,const TDesC16 &,const TDesC16 &,TReqPriorityType)const
RTelSubSessionBase::Set(const TInt,TRequestStatus &,const TDesC8 &,TReqPriorityType)const
RTelSubSessionBase::Set(const TInt,TRequestStatus &,const TDesC8 &,const TDesC16 &,TReqPriorityType)const
RTelSubSessionBase::Set(const TInt,TRequestStatus &,const TDesC8 &,const TDesC8 &,TReqPriorityType)const
RTelSubSessionBase::Set(const TInt,const RFile &,TReqPriorityType)const
RTelSubSessionBase::Set(const TInt,const TDesC16 &,TReqPriorityType)const
RTelSubSessionBase::Set(const TInt,const TDesC16 &,const TDesC16 &,TReqPriorityType)const
RTelSubSessionBase::Set(const TInt,const TDesC8 &,TReqPriorityType)const
RTelSubSessionBase::Set(const TInt,const TDesC8 &,const TDesC16 &,TReqPriorityType)const
RTelSubSessionBase::Set(const TInt,const TDesC8 &,const TDesC8 &,TReqPriorityType)const
RTelSubSessionBase::SetAndGet(const TInt,TRequestStatus &,TDes8 &,const TDesC16 &,TReqPriorityType)const
RTelSubSessionBase::SetAndGet(const TInt,TRequestStatus &,const TDesC16 &,TDes16 &,TReqPriorityType)const
RTelSubSessionBase::SetAndGet(const TInt,TRequestStatus &,const TDesC8 &,TDes16 &,TReqPriorityType)const
RTelSubSessionBase::SetAndGet(const TInt,TRequestStatus &,const TDesC8 &,TDes8 &,TReqPriorityType)const
RTelSubSessionBase::SetSessionHandle(RSessionBase &)
RTelSubSessionBase::SubSessionHandle()
Public Member Enumerations
enum anonymous { KMaxNamParamSize  = 64, KMaxNamParamSizeV4  = 256 }
enum TStandardNamParameters {
EAKey , ESharedSecretDataA , ESharedSecretDataB , EParameterUpdateReceivedCount , EMinBasedImsiClass , ETrueImsiClass , EMinBasedImsiS , ETrueImsiS , EMinBasedImsiAddressNum , ETrueImsiAddressNum , EMinBasedImsiDigits11and12 , ETrueImsiDigits11and12 , EMinBasedMobileCountryCode , ETrueMobileCountryCode , EMobileDirectoryNumber , EAssigningTmsiZoneLen , EAssigningTmsiZone , ETmsiCode , ETmsiExpTime , EHomeSystemIdAnalog , EHomeSystemId , EHomeNetworkId , EReceiveCallsHome , EReceiveCallsForeignSystem , EReceiveCallsForeignNetwork , ENumStandardNamParameters
}
Inherited Enumerations
RMobilePhoneStore:TMobilePhoneStoreCaps
RMobilePhoneStore:TMobilePhoneStoreInfoExtId
RMobilePhoneStore:TMobilePhoneStoreType
RMobilePhoneStore:TMobileStoreEvent
RTelSubSessionBase:TReqPriorityType
Public Member Type Definitions
typedef TPckg < TMobileNamEntryV1 > TMobileNamEntryV1Pckg
typedef TPckg < TMobileNamEntryV4 > TMobileNamEntryV4Pckg
typedef TPckg < TMobileNamStoreInfoV1 > TMobileNamStoreInfoV1Pckg
Inherited Attributes
RMobilePhoneStore::iStorePtrHolder
RTelSubSessionBase::iPtrHolder

Constructor & Destructor Documentation

RMobileNamStore()

IMPORT_C RMobileNamStore ( )

Constructor.

RMobileNamStore(const RMobileNamStore &)

RMobileNamStore ( const RMobileNamStore & ) [private]

Parameters

const RMobileNamStore &

Member Functions Documentation

Close()

IMPORT_C void Close ( )
This member function closes a RMobileNamStore subsession.
capability
None

ConstructL()

IMPORT_C void ConstructL ( ) [protected]

Initializes and allocated the members of the RMobileNamStore object.

leave
KErrNoMemory Out of memory
capability
None

Open(RMobilePhone &)

IMPORT_C TInt Open ( RMobilePhone & aPhone )

This member function opens a RMobileNamStore subsession from RMobilePhone .

capability
None

Parameters

RMobilePhone & aPhone The phone subsession to use.

SetActiveNam(TRequestStatus &, TInt)

IMPORT_C void SetActiveNam ( TRequestStatus & aReqStatus,
TInt aNamId
) const

This member function sets a new value for the active NAM.

capability
WriteDeviceData

Parameters

TRequestStatus & aReqStatus On return, KErrNone if successful, a system-wide error code if not.
TInt aNamId Specifies which NAM to activate.

StoreAllL(TRequestStatus &, TInt, CMobilePhoneNamList *)

IMPORT_C void StoreAllL ( TRequestStatus & aReqStatus,
TInt aNamId,
CMobilePhoneNamList * aNamList
) const

This member function stores a new version of the NAM list.

leave
KErrNoMemory Out of memory
capability
WriteDeviceData

Parameters

TRequestStatus & aReqStatus On return, KErrNone if successful, a system-wide error code if not.
TInt aNamId Specifies which NAM to use.
CMobilePhoneNamList * aNamList Pointer to the list containing the NAM entries to store.

StoreAllL(TRequestStatus &, TInt, CMobilePhoneNamListV4 *)

IMPORT_C void StoreAllL ( TRequestStatus & aReqStatus,
TInt aNamId,
CMobilePhoneNamListV4 * aNamList
) const

This member function stores a new version of the NAM list.

leave
KErrNoMemory Out of memory
capability
WriteDeviceData

Parameters

TRequestStatus & aReqStatus On return, KErrNone if successful, a system-wide error code if not.
TInt aNamId Specifies which NAM to use.
CMobilePhoneNamListV4 * aNamList Pointer to the list containing the NAM entries to store.

Member Enumerations Documentation

Enum anonymous

Enumerators

KMaxNamParamSize = 64
KMaxNamParamSizeV4 = 256

Enum TStandardNamParameters

Enumeration for the standard NAM parameters (see 3GPP2 C.S0005-A appendix F.3) Modes: CDMA

Enumerators

EAKey

The 64-bit pattern stored in the Mobile Station and Home Location Register/Authentication Centre used to generate/update the mobile station s Shared Secret Data Corresponds to NAM Indicator 'A_KEY'

ESharedSecretDataA

64-bit key used for authentication Corresponds to NAM Indicator 'SSD_A(s-p)'

ESharedSecretDataB

64-bit key used as input to generate encryption mask and long code Corresponds to NAM Indicator 'SSD_B(s-p)'

EParameterUpdateReceivedCount

Modulo-64 event counter maintained by the mobile station and Authentication Center used for clone detection Corresponds to NAM Indicator 'COUNT(s-p)'

EMinBasedImsiClass

Class of the International Mobile Station Identity (IMSI) containing a MIN as the lower 10 digits Corresponds to NAM Indicator 'IMSI_M_CLASS(p)'

ETrueImsiClass

The class of the International Mobile Station Identity (IMSI) not containing a MIN as the lower 10 digits Corresponds to NAM Indicator 'IMSI_T_CLASS(p)'

EMinBasedImsiS

34-bit number derived from the IMSI M used as input for authentication Corresponds to NAM Indicator 'IMSI_M_S(p)'

ETrueImsiS

34-bit number derived from the IMSI T used as input for authentication Corresponds to NAM Indicator 'IMSI_T_S(p)'

EMinBasedImsiAddressNum

Number of digits in the IMSI M minus 4 Corresponds to NAM Indicator 'IMSI_M_ADDR_NUM(p)'

ETrueImsiAddressNum

The number of digits in the IMSI T minus 4 Corresponds to NAM Indicator 'IMSI_T_ADDR_NUM(p)'

EMinBasedImsiDigits11and12

The 11th and 12th digits in the IMSI M Corresponds to NAM Indicator 'IMSI_M_11_12(p)'

ETrueImsiDigits11and12

The 11th and 12th digits in the IMSI T Corresponds to NAM Indicator 'IMSI_T_11_12(p)'

EMinBasedMobileCountryCode

The country code for the IMSI M Corresponds to NAM Indicator 'MCC_M(p)'

ETrueMobileCountryCode

The country code for the IMSI T Corresponds to NAM Indicator 'MCC_T(p)'

EMobileDirectoryNumber

Up to 15 digit dialable number associated with the mobile station through a service subscription Corresponds to NAM Indicator 'MDN(p)'

EAssigningTmsiZoneLen

4-bit number giving the length of the assigning Temporary Mobile Station Identity (TMSI) zone (can range from 1 to 8 octets) Corresponds to NAM Indicator 'ASSIGNING_TMSI_ZONE_LEN(s-p)'

EAssigningTmsiZone

Temporary Mobile Station Identity (TMSI) zone is an arbitrary set of base stations for the administrative assignment of TMSI Corresponds to NAM Indicator 'ASSIGNING_TMSI_ZONE(s-p)'

ETmsiCode

The uniquely assigned number to a mobile station inside a TMSI zone Corresponds to NAM Indicator 'TMSI_CODE(s-p)'

ETmsiExpTime

The expiration time used to automatically delete the assigned TMSI Corresponds to NAM Indicator 'TMSI_EXP_TIME(s-p)'

EHomeSystemIdAnalog

Mobile station's home System Id for 800MHz analog operation Corresponds to NAM Indicator 'HOME_SID(p)'

EHomeSystemId

Mobile station's home System Id Corresponds to NAM Indicator 'SID(p)'

EHomeNetworkId

Mobile station's home Network Id Corresponds to NAM Indicator 'NID(p)'

EReceiveCallsHome

Mobile station is configured to receive mobile station terminated calls when using a home (SID, NID) pair Corresponds to NAM Indicator 'MOB_TERM_HOME(p)'

EReceiveCallsForeignSystem

The mobile station is configured to receive mobile station terminated calls when it is a foreign SID roamer Corresponds to NAM Indicator 'MOB_TERM_FOR_SID(p)'

EReceiveCallsForeignNetwork

The mobile station is configured to receive mobile station terminated calls when it is a foreign NID roamer Corresponds to NAM Indicator 'MOB_TERM_FOR_NID(p)'

ENumStandardNamParameters

A TSY may use this as the first TSY-defined non-standard NAM parameter

Member Type Definitions Documentation

Typedef TMobileNamEntryV1Pckg

typedef TPckg < TMobileNamEntryV1 > TMobileNamEntryV1Pckg

A typedef'd packaged TMobileNamEntryV1 for passing through a generic API member function.

Typedef TMobileNamEntryV4Pckg

typedef TPckg < TMobileNamEntryV4 > TMobileNamEntryV4Pckg

A typedef'd packaged TMobileNamEntryV4 for passing through a generic API member function.

Typedef TMobileNamStoreInfoV1Pckg

typedef TPckg < TMobileNamStoreInfoV1 > TMobileNamStoreInfoV1Pckg

A typedef'd packaged TMobileNamStoreInfoV1 for passing through a generic API member function.