CTelephony Class Reference

class CTelephony : public CBase

This class provides a simple interface to the phone's telephony system. It provides two services:

1. You can find out information about the phone. This class provides support for retrieving Phone Settings, Line Information, Call Functionality, Network Information and (basic) Supplementary Service Settings.

2. You can dial, answer and control voice calls. You cannot make fax or data calls.

Architecturally, CTelephony provides an interface to the Telephony Multimode API. This interface exposes only a subset of the complete Multimode functionality.

Note that a CActiveScheduler is required to be installed for all asynchronous CTelephony calls.

Inherits from

Public Member Functions
~CTelephony()
IMPORT_C voidAnswerIncomingCall(TRequestStatus &, TCallId &, const TPhoneLine)
IMPORT_C TIntCancelAsync(TCancellationRequest)
IMPORT_C voidCancelEstablishDataCall()
IMPORT_C voidCancelReceiveDataCall()
IMPORT_C voidDialNewCall(TRequestStatus &, TDes8 &, const TTelNumber &, TCallId &, const TPhoneLine)
IMPORT_C TIntEstablishDataCall(TInt &, const TDesC &)
IMPORT_C voidEstablishDataCall(TRequestStatus &, TInt &, const TDesC &)
IMPORT_C TIntFindDeviceStatus(TInt &)
IMPORT_C voidGetBatteryInfo(TRequestStatus &, TDes8 &)
IMPORT_C voidGetCallBarringStatus(TRequestStatus &, const TCallBarringCondition, TDes8 &, const TServiceGroup)
IMPORT_C TIntGetCallDynamicCaps(const TCallId &, TDes8 &)
IMPORT_C voidGetCallForwardingStatus(TRequestStatus &, const TCallForwardingCondition, TDes8 &, const TServiceGroup)
IMPORT_C TIntGetCallInfo(TDes8 &, TDes8 &, TDes8 &)
IMPORT_C TIntGetCallStatus(const TCallId &, TDes8 &)
IMPORT_C voidGetCallWaitingStatus(TRequestStatus &, TDes8 &, const TServiceGroup)
IMPORT_C voidGetCurrentNetworkInfo(TRequestStatus &, TDes8 &)
IMPORT_C voidGetCurrentNetworkName(TRequestStatus &, TDes8 &)
IMPORT_C voidGetFlightMode(TRequestStatus &, TDes8 &)
IMPORT_C voidGetIdentityServiceStatus(TRequestStatus &, const TIdentityService &, TDes8 &)
IMPORT_C voidGetIndicator(TRequestStatus &, TDes8 &)
IMPORT_C TIntGetLineStatus(const TPhoneLine &, TDes8 &)
IMPORT_C voidGetLockInfo(TRequestStatus &, const TIccLock &, TDes8 &)
IMPORT_C voidGetNetworkRegistrationStatus(TRequestStatus &, TDes8 &)
IMPORT_C voidGetOperatorName(TRequestStatus &, TDes8 &)
IMPORT_C voidGetPhoneId(TRequestStatus &, TDes8 &)
IMPORT_C voidGetSignalStrength(TRequestStatus &, TDes8 &)
IMPORT_C voidGetSubscriberId(TRequestStatus &, TDes8 &)
IMPORT_C voidHangup(TRequestStatus &, const TCallId &)
IMPORT_C voidHold(TRequestStatus &, const TCallId &)
IMPORT_C CTelephony *NewL()
IMPORT_C CTelephony *NewLC()
IMPORT_C voidNotifyChange(TRequestStatus &, const TNotificationEvent &, TDes8 &)
IMPORT_C TIntReceiveDataCall(TInt &)
IMPORT_C voidReceiveDataCall(TRequestStatus &, TInt &)
IMPORT_C voidResume(TRequestStatus &, const TCallId &)
IMPORT_C voidSendDTMFTones(TRequestStatus &, const TDesC &)
IMPORT_C voidSwap(TRequestStatus &, const TCallId &, const TCallId &)
IMPORT_C TIntTerminateDataCall()
TVersion Version()
Private Member Functions
CTelephony()
voidConstructL()
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
enumanonymous { KEtelISVV1 = 1, KEtelISVV2 = 2 }
enumTBatteryStatus { EPowerStatusUnknown, EPoweredByBattery, EBatteryConnectedButExternallyPowered, ENoBatteryConnected, EPowerFault }
enumTCallBarringCondition { EBarAllIncoming, EBarIncomingRoaming, EBarAllOutgoing, EBarOutgoingInternational, EBarOutgoingInternationalExHC }
enumTCallDirection { EDirectionUnknown, EMobileOriginated, EMobileTerminated }
enumTCallForwardingCondition { ECallForwardingUnconditional, ECallForwardingBusy, ECallForwardingNoReply, ECallForwardingNotReachable }
enumTCallId { EISVCall1, EISVCall2, EISVMaxNumOfCalls }
enumTCallRemoteIdentityStatus { ERemoteIdentityUnknown, ERemoteIdentityAvailable, ERemoteIdentitySuppressed }
enumTCallSelect { EActiveCall, EHeldCall, EInProgressCall }
enumTCallStatus {
EStatusUnknown, EStatusIdle, EStatusDialling, EStatusRinging, EStatusAnswering, EStatusConnecting, EStatusConnected, EStatusReconnectPending, EStatusDisconnecting, EStatusHold, EStatusTransferring, EStatusTransferAlerting
}
enumTCallerIdentityRestrict { EIdRestrictDefault, ESendMyId, EDontSendMyId }
enumTCancellationRequest {
EGetPhoneIdCancel, EGetSubscriberIdCancel, EGetFlightModeCancel, EFlightModeChangeCancel, EGetIndicatorCancel, EIndicatorChangeCancel, EGetBatteryInfoCancel, EBatteryInfoChangeCancel, EGetSignalStrengthCancel, ESignalStrengthChangeCancel, EGetLockInfoCancel, EPin1LockInfoChangeCancel, EPin2LockInfoChangeCancel, EVoiceLineStatusChangeCancel, EOwnedCall1StatusChangeCancel, EOwnedCall2StatusChangeCancel, EOwnedCall1RemotePartyInfoChangeCancel, EOwnedCall2RemotePartyInfoChangeCancel, ESendDTMFTonesCancel, EDialNewCallCancel, EHoldCancel, EResumeCancel, ESwapCancel, EHangupCancel, EAnswerIncomingCallCancel, EGetNetworkRegistrationStatusCancel, ENetworkRegistrationStatusChangeCancel, EGetCurrentNetworkInfoCancel, ECurrentNetworkInfoChangeCancel, EGetCurrentNetworkNameCancel, EGetOperatorNameCancel, EGetCallForwardingStatusCancel, EGetCallBarringStatusCancel, EGetCallWaitingStatusCancel, EGetIdentityServiceStatusCancel, EFaxLineStatusChangeCancel, EDataLineStatusChangeCancel
}
enumTFlightModeStatus { EFlightModeOff = 0, EFlightModeOn = 1 }
enumTIccLock { ELockPin1, ELockPin2 }
enumTIccLockSetting { ELockSetUnknown, ELockSetEnabled, ELockSetDisabled }
enumTIccLockStatus { EStatusLockUnknown, EStatusLocked, EStatusUnlocked, EStatusBlocked }
enumTIdentityService { EIdServiceUnspecified, EIdServiceCallerPresentation, EIdServiceCallerRestriction }
enumTIdentityServiceStatus { EIdServiceActivePermanent, EIdServiceActiveDefaultRestricted, EIdServiceActiveDefaultAllowed, EIdServiceNotProvisioned, EIdServiceUnknown }
enumTMobileCallControlCaps { KCapsHold = 0x00000200, KCapsResume = 0x00000400, KCapsSwap = 0x00000800 }
enumTNetworkAccess { ENetworkAccessUnknown, ENetworkAccessGsm, ENetworkAccessGsmCompact, ENetworkAccessUtran }
enumTNetworkBandInfo {
EBandUnknown, E800BandA, E800BandB, E800BandC, E1900BandA, E1900BandB, E1900BandC, E1900BandD, E1900BandE, E1900BandF
}
enumTNetworkMode {
ENetworkModeUnknown, ENetworkModeUnregistered, ENetworkModeGsm, ENetworkModeAmps, ENetworkModeCdma95, ENetworkModeCdma2000, ENetworkModeWcdma, ENetworkModeTdcdma
}
enumTNetworkStatus { ENetworkStatusUnknown, ENetworkStatusAvailable, ENetworkStatusCurrent, ENetworkStatusForbidden }
enumTNotificationEvent {
EFlightModeChange, EIndicatorChange, EBatteryInfoChange, ESignalStrengthChange, EPin1LockInfoChange, EPin2LockInfoChange, EVoiceLineStatusChange, EOwnedCall1StatusChange, EOwnedCall2StatusChange, EOwnedCall1RemotePartyInfoChange, EOwnedCall2RemotePartyInfoChange, ENetworkRegistrationStatusChange, ECurrentNetworkInfoChange, EFaxLineStatusChange, EDataLineStatusChange
}
enumTPhoneIndicators { KIndChargerConnected = 0x00000001, KIndNetworkAvailable = 0x00000002, KIndCallInProgress = 0x00000004 }
enumTPhoneLine { EVoiceLine, EDataLine, EFaxLine }
enumTPhoneNetworkSecurity { ECipheringOff, ECipheringGSM, ECipheringWCDMA }
enumTRegistrationStatus {
ERegistrationUnknown, ENotRegisteredNoService, ENotRegisteredEmergencyOnly, ENotRegisteredSearching, ERegisteredBusy, ERegisteredOnHomeNetwork, ERegistrationDenied, ERegisteredRoaming
}
enumTServiceGroup { EVoiceService, EFaxService, EDataService }
enumTSupplServiceStatus { EStatusActive, ENotActive, ENotProvisioned, ENotAvailable, EUnknown }
enumTTelNumberNPI {
EUnknownNumberingPlan = 0, EIsdnNumberPlan = 1, EDataNumberPlan = 3, ETelexNumberPlan = 4, EServiceCentreSpecificPlan1 = 5, EServiceCentreSpecificPlan2 = 6, ENationalNumberPlan = 8, EPrivateNumberPlan = 9, EERMESNumberPlan = 10
}
enumTTelNumberTON {
EUnknownNumber, EInternationalNumber, ENationalNumber, ENetworkSpecificNumber, ESubscriberNumber, EAlphanumericNumber, EAbbreviatedNumber
}
Public Member Type Definitions
typedef TPckg< TBatteryInfoV1 > TBatteryInfoV1Pckg
typedef TPckg< TCallBarringSupplServicesV1 > TCallBarringSupplServicesV1Pckg
typedef TPckg< TCallCapsV1 > TCallCapsV1Pckg
typedef TPckg< TCallForwardingSupplServicesV1 > TCallForwardingSupplServicesV1Pckg
typedef TPckg< TCallInfoV1 > TCallInfoV1Pckg
typedef TPckg< TCallParamsV1 > TCallParamsV1Pckg
typedef TPckg< TCallSelectionV1 > TCallSelectionV1Pckg
typedef TPckg< TCallStatusV1 > TCallStatusV1Pckg
typedef TPckg< TCallWaitingSupplServicesV1 > TCallWaitingSupplServicesV1Pckg
typedef TPckg< TFlightModeV1 > TFlightModeV1Pckg
typedef TPckg< TIccLockInfoV1 > TIccLockInfoV1Pckg
typedef TPckg< TIdentityServiceV1 > TIdentityServiceV1Pckg
typedef TPckg< TIndicatorV1 > TIndicatorV1Pckg
typedef TPckg< TNetworkInfoV1 > TNetworkInfoV1Pckg
typedef TPckg< TNetworkInfoV2 > TNetworkInfoV2Pckg
typedef TPckg< TNetworkNameV1 > TNetworkNameV1Pckg
typedef TPckg< TNetworkNameV2 > TNetworkNameV2Pckg
typedef TPckg< TNetworkRegistrationV1 > TNetworkRegistrationV1Pckg
typedef TPckg< TOperatorNameV1 > TOperatorNameV1Pckg
typedef TPckg< TPhoneIdV1 > TPhoneIdV1Pckg
typedef TPckg< TRemotePartyInfoV1 > TRemotePartyInfoV1Pckg
typedef TPckg< TSignalStrengthV1 > TSignalStrengthV1Pckg
typedef TPckg< TSubscriberIdV1 > TSubscriberIdV1Pckg
typedef TBuf< KMaxTelNumberSize > TTelNumber
Private Attributes
CTelephonyFunctions *iTelephonyFunctions

Constructor & Destructor Documentation

CTelephony()

CTelephony()[private]

~CTelephony()

~CTelephony()

Member Functions Documentation

AnswerIncomingCall(TRequestStatus &, TCallId &, const TPhoneLine)

IMPORT_C voidAnswerIncomingCall(TRequestStatus &aReqStatus,
TCallId &aCallId,
const TPhoneLineaLine = EVoiceLine
)const

Parameters

TRequestStatus & aReqStatus
TCallId & aCallId
const TPhoneLine aLine = EVoiceLine

CancelAsync(TCancellationRequest)

IMPORT_C TIntCancelAsync(TCancellationRequestaCancel)const

Parameters

TCancellationRequest aCancel

CancelEstablishDataCall()

IMPORT_C voidCancelEstablishDataCall()

CancelReceiveDataCall()

IMPORT_C voidCancelReceiveDataCall()

ConstructL()

voidConstructL()[private]

DialNewCall(TRequestStatus &, TDes8 &, const TTelNumber &, TCallId &, const TPhoneLine)

IMPORT_C voidDialNewCall(TRequestStatus &aStatus,
TDes8 &aCallParams,
const TTelNumber &aTelNumber,
TCallId &aCallId,
const TPhoneLineaLine = EVoiceLine
)const

Parameters

TRequestStatus & aStatus
TDes8 & aCallParams
const TTelNumber & aTelNumber
TCallId & aCallId
const TPhoneLine aLine = EVoiceLine

EstablishDataCall(TInt &, const TDesC &)

IMPORT_C TIntEstablishDataCall(TInt &aDataChannel,
const TDesC &aDialNumber
)

Parameters

TInt & aDataChannel
const TDesC & aDialNumber

EstablishDataCall(TRequestStatus &, TInt &, const TDesC &)

IMPORT_C voidEstablishDataCall(TRequestStatus &aRequestStatus,
TInt &aDataChannel,
const TDesC &aDialNumber
)

Parameters

TRequestStatus & aRequestStatus
TInt & aDataChannel
const TDesC & aDialNumber

FindDeviceStatus(TInt &)

IMPORT_C TIntFindDeviceStatus(TInt &aCallStatus)

Parameters

TInt & aCallStatus

GetBatteryInfo(TRequestStatus &, TDes8 &)

IMPORT_C voidGetBatteryInfo(TRequestStatus &aReqStatus,
TDes8 &aBatteryInfo
)const

Parameters

TRequestStatus & aReqStatus
TDes8 & aBatteryInfo

GetCallBarringStatus(TRequestStatus &, const TCallBarringCondition, TDes8 &, const TServiceGroup)

IMPORT_C voidGetCallBarringStatus(TRequestStatus &aRequestStatus,
const TCallBarringConditionaCondition,
TDes8 &aSSInfo,
const TServiceGroupaServiceGroup = EVoiceService
)const

Parameters

TRequestStatus & aRequestStatus
const TCallBarringCondition aCondition
TDes8 & aSSInfo
const TServiceGroup aServiceGroup = EVoiceService

GetCallDynamicCaps(const TCallId &, TDes8 &)

IMPORT_C TIntGetCallDynamicCaps(const TCallId &aCallId,
TDes8 &aCallCaps
)const

Parameters

const TCallId & aCallId
TDes8 & aCallCaps

GetCallForwardingStatus(TRequestStatus &, const TCallForwardingCondition, TDes8 &, const TServiceGroup)

IMPORT_C voidGetCallForwardingStatus(TRequestStatus &aRequestStatus,
const TCallForwardingConditionaCondition,
TDes8 &aSSInfo,
const TServiceGroupaServiceGroup = EVoiceService
)const

Parameters

TRequestStatus & aRequestStatus
const TCallForwardingCondition aCondition
TDes8 & aSSInfo
const TServiceGroup aServiceGroup = EVoiceService

GetCallInfo(TDes8 &, TDes8 &, TDes8 &)

IMPORT_C TIntGetCallInfo(TDes8 &aCallSelect,
TDes8 &aCallInfo,
TDes8 &aRemoteInfo
)const

Parameters

TDes8 & aCallSelect
TDes8 & aCallInfo
TDes8 & aRemoteInfo

GetCallStatus(const TCallId &, TDes8 &)

IMPORT_C TIntGetCallStatus(const TCallId &aCallId,
TDes8 &aCallStatus
)const

Parameters

const TCallId & aCallId
TDes8 & aCallStatus

GetCallWaitingStatus(TRequestStatus &, TDes8 &, const TServiceGroup)

IMPORT_C voidGetCallWaitingStatus(TRequestStatus &aRequestStatus,
TDes8 &aSSInfo,
const TServiceGroupaServiceGroup = EVoiceService
)const

Parameters

TRequestStatus & aRequestStatus
TDes8 & aSSInfo
const TServiceGroup aServiceGroup = EVoiceService

GetCurrentNetworkInfo(TRequestStatus &, TDes8 &)

IMPORT_C voidGetCurrentNetworkInfo(TRequestStatus &aReqStatus,
TDes8 &aNetworkInfo
)const

Parameters

TRequestStatus & aReqStatus
TDes8 & aNetworkInfo

GetCurrentNetworkName(TRequestStatus &, TDes8 &)

IMPORT_C voidGetCurrentNetworkName(TRequestStatus &aReqStatus,
TDes8 &aNetworkName
)const

Parameters

TRequestStatus & aReqStatus
TDes8 & aNetworkName

GetFlightMode(TRequestStatus &, TDes8 &)

IMPORT_C voidGetFlightMode(TRequestStatus &aReqStatus,
TDes8 &aMode
)const

Parameters

TRequestStatus & aReqStatus
TDes8 & aMode

GetIdentityServiceStatus(TRequestStatus &, const TIdentityService &, TDes8 &)

IMPORT_C voidGetIdentityServiceStatus(TRequestStatus &aReqStatus,
const TIdentityService &aService,
TDes8 &aStatus
)const

Parameters

TRequestStatus & aReqStatus
const TIdentityService & aService
TDes8 & aStatus

GetIndicator(TRequestStatus &, TDes8 &)

IMPORT_C voidGetIndicator(TRequestStatus &aReqStatus,
TDes8 &aIndicator
)const

Parameters

TRequestStatus & aReqStatus
TDes8 & aIndicator

GetLineStatus(const TPhoneLine &, TDes8 &)

IMPORT_C TIntGetLineStatus(const TPhoneLine &aLine,
TDes8 &aStatus
)const

Parameters

const TPhoneLine & aLine
TDes8 & aStatus

GetLockInfo(TRequestStatus &, const TIccLock &, TDes8 &)

IMPORT_C voidGetLockInfo(TRequestStatus &aReqStatus,
const TIccLock &aLock,
TDes8 &aLockInfo
)const

Parameters

TRequestStatus & aReqStatus
const TIccLock & aLock
TDes8 & aLockInfo

GetNetworkRegistrationStatus(TRequestStatus &, TDes8 &)

IMPORT_C voidGetNetworkRegistrationStatus(TRequestStatus &aReqStatus,
TDes8 &aStatus
)const

Parameters

TRequestStatus & aReqStatus
TDes8 & aStatus

GetOperatorName(TRequestStatus &, TDes8 &)

IMPORT_C voidGetOperatorName(TRequestStatus &aReqStatus,
TDes8 &aOperator
)const

Parameters

TRequestStatus & aReqStatus
TDes8 & aOperator

GetPhoneId(TRequestStatus &, TDes8 &)

IMPORT_C voidGetPhoneId(TRequestStatus &aReqStatus,
TDes8 &aId
)const

Parameters

TRequestStatus & aReqStatus
TDes8 & aId

GetSignalStrength(TRequestStatus &, TDes8 &)

IMPORT_C voidGetSignalStrength(TRequestStatus &aReqStatus,
TDes8 &aSignalStrength
)const

Parameters

TRequestStatus & aReqStatus
TDes8 & aSignalStrength

GetSubscriberId(TRequestStatus &, TDes8 &)

IMPORT_C voidGetSubscriberId(TRequestStatus &aReqStatus,
TDes8 &aId
)const

Parameters

TRequestStatus & aReqStatus
TDes8 & aId

Hangup(TRequestStatus &, const TCallId &)

IMPORT_C voidHangup(TRequestStatus &aReqStatus,
const TCallId &aCallId
)const

Parameters

TRequestStatus & aReqStatus
const TCallId & aCallId

Hold(TRequestStatus &, const TCallId &)

IMPORT_C voidHold(TRequestStatus &aReqStatus,
const TCallId &aCallId
)const

Parameters

TRequestStatus & aReqStatus
const TCallId & aCallId

NewL()

IMPORT_C CTelephony *NewL()[static]

NewLC()

IMPORT_C CTelephony *NewLC()[static]

NotifyChange(TRequestStatus &, const TNotificationEvent &, TDes8 &)

IMPORT_C voidNotifyChange(TRequestStatus &aReqStatus,
const TNotificationEvent &aEvent,
TDes8 &aDes
)const

Parameters

TRequestStatus & aReqStatus
const TNotificationEvent & aEvent
TDes8 & aDes

ReceiveDataCall(TInt &)

IMPORT_C TIntReceiveDataCall(TInt &aDataChannel)

Parameters

TInt & aDataChannel

ReceiveDataCall(TRequestStatus &, TInt &)

IMPORT_C voidReceiveDataCall(TRequestStatus &aRequestStatus,
TInt &aDataChannel
)

Parameters

TRequestStatus & aRequestStatus
TInt & aDataChannel

Resume(TRequestStatus &, const TCallId &)

IMPORT_C voidResume(TRequestStatus &aReqStatus,
const TCallId &aCallId
)const

Parameters

TRequestStatus & aReqStatus
const TCallId & aCallId

SendDTMFTones(TRequestStatus &, const TDesC &)

IMPORT_C voidSendDTMFTones(TRequestStatus &aReqStatus,
const TDesC &aTones
)const

Parameters

TRequestStatus & aReqStatus
const TDesC & aTones

Swap(TRequestStatus &, const TCallId &, const TCallId &)

IMPORT_C voidSwap(TRequestStatus &aReqStatus,
const TCallId &aCallId1,
const TCallId &aCallId2
)const

Parameters

TRequestStatus & aReqStatus
const TCallId & aCallId1
const TCallId & aCallId2

TerminateDataCall()

IMPORT_C TIntTerminateDataCall()

Version()

TVersion Version()const [inline]

Get current CTelephony version

This function returns major, minor, and build version-numbers.

TVersion object, see E32STD.H

Member Enumerations Documentation

Enum anonymous

Unique parameter class identifier.

Enumerators

KEtelISVV1 = 1

Unique reference identifier for Etel 3rd Party v1.0 parameter classes.

KEtelISVV2 = 2

Unique reference identifier for Etel 3rd Party v2.0 parameter classes.

Enum TBatteryStatus

The mobile phone battery status.

Enumerators

EPowerStatusUnknown

The phone software can not determine the phone's current power status.

EPoweredByBattery

The phone is powered by the battery.

EBatteryConnectedButExternallyPowered

A battery is connected, but the phone is externally powered.

ENoBatteryConnected

No battery is connected.

EPowerFault

Power fault.

Enum TCallBarringCondition

Call Barring conditions.

Enumerators

EBarAllIncoming

All incoming calls to this subscriber are barred (BAIC).

EBarIncomingRoaming

All incoming calls to this subscriber are barred when roaming outside the home PLMN country (BAIC-roam).

EBarAllOutgoing

All outgoing calls by this subscriber are barred (BAOC).

EBarOutgoingInternational

All outgoing international calls by this subscriber are barred (BOIC).

EBarOutgoingInternationalExHC

All outgoing international calls except those directed to the home PLMN country by this subscriber are barred (BOIC-ExHC).

Enum TCallDirection

The direction of the call.

Enumerators

EDirectionUnknown

The direction of the call is unknown.

EMobileOriginated

The call was originated by this phone, i.e. it is an outgoing call.

EMobileTerminated

The call was terminated by this phone, i.e. it is an incoming call.

Enum TCallForwardingCondition

Call Forwarding conditions.

Enumerators

ECallForwardingUnconditional

All calls to this subscriber are forwarded.

ECallForwardingBusy

Calls are forwarded when this subscriber is busy.

ECallForwardingNoReply

Calls are forwarded when this subscriber does not reply within a timeout period.

ECallForwardingNotReachable

Calls are forwarded when this subscriber is unreachable.

Enum TCallId

Etel 3rd Party owned call identifiers

Enumerators

EISVCall1

Call owned by this ISV application.

EISVCall2

Call owned by this ISV application.

EISVMaxNumOfCalls

Max number of calls supported by Etel 3rd Party.

Enum TCallRemoteIdentityStatus

Remote party identity status.

Enumerators

ERemoteIdentityUnknown

The remote party's identity can not be determined.

ERemoteIdentityAvailable

The remote party's identity is available.

ERemoteIdentitySuppressed

The remote party has suppressed the transmission of its identity.

Enum TCallSelect

Select a call defined by it current stats.

Enumerators

EActiveCall

Currently active call.

EHeldCall

Currently held (applicable only for voice) call.

EInProgressCall

Call during the setup/disconnecting process - (dialling/connecting/answering/hanging up).

Enum TCallStatus

Describes the possible call or line states.

Enumerators

EStatusUnknown

Indicates that the status is unknown.

EStatusIdle

Idle line status (no active calls).

EStatusDialling

Call dialling status .

EStatusRinging

Call ringing status.

EStatusAnswering

Call answering status.

EStatusConnecting

Call connecting status.

EStatusConnected

Call connected status.

EStatusReconnectPending

Call is undergoing temporary channel loss and it may or may not be reconnected.

EStatusDisconnecting

Call disconnecting status.

EStatusHold

Call on hold.

EStatusTransferring

Call is transferring.

EStatusTransferAlerting

Call in transfer is alerting the remote party.

Enum TCallerIdentityRestrict

Caller Id restriction settings.

Enumerators

EIdRestrictDefault

The default setting should be used if the user has not explicitly requested their identity to be restricted/allowed.

ESendMyId

The user has explicitly requested their identity to be sent for this call.

EDontSendMyId

The user has explicitly requested their identity not to be sent for this call.

Enum TCancellationRequest

Cancel apending request

Enumerators

EGetPhoneIdCancel

Cancel a pending GetPhoneId request.

EGetSubscriberIdCancel

Cancel a pending GetSubscriberId request.

EGetFlightModeCancel

Cancel a pending GetFlightMode request.

EFlightModeChangeCancel

Cancel a pending FlightModeChange request.

EGetIndicatorCancel

Cancel a pending GetIndicator request.

EIndicatorChangeCancel

Cancel a pending IndicatorChange request.

EGetBatteryInfoCancel

Cancel a pending GetBatteryInfo request.

EBatteryInfoChangeCancel

Cancel a pending BatteryInfoChange request.

EGetSignalStrengthCancel

Cancel a pending GetSignalStrength request.

ESignalStrengthChangeCancel

Cancel a pending SignalStrengthChange request.

EGetLockInfoCancel

Cancel a pending GetLockInfo request.

EPin1LockInfoChangeCancel

Cancel a pending Pin 1 LockInfoChange request.

EPin2LockInfoChangeCancel

Cancel a pending Pin 2 LockInfoChange request.

EVoiceLineStatusChangeCancel

Cancel a pending VoiceLineStatusChange request.

EOwnedCall1StatusChangeCancel

Cancel a pending Call1StatusChange request.

EOwnedCall2StatusChangeCancel

Cancel a pending Call2StatusChange request.

EOwnedCall1RemotePartyInfoChangeCancel

Cancel a pending OwnedCall1RemotePartyInfoChange request.

EOwnedCall2RemotePartyInfoChangeCancel

Cancel a pending OwnedCall2RemotePartyInfoChange request.

ESendDTMFTonesCancel

Cancel a pending SendDTMFTones request.

EDialNewCallCancel

Cancel a pending DialNewCall request.

EHoldCancel

Cancel a pending Hold request.

EResumeCancel

Cancel a pending Resume request.

ESwapCancel

Cancel a pending Swap request.

EHangupCancel

Cancel a pending Hangup request.

EAnswerIncomingCallCancel

Cancel a pending AnswerIncomingCall request.

EGetNetworkRegistrationStatusCancel

Cancel a pending GetNetworkRegistrationStatus request.

ENetworkRegistrationStatusChangeCancel

Cancel a pending NetworkRegistrationStatusChange request.

EGetCurrentNetworkInfoCancel

Cancel a pending GetCurrentNetworkInfo request.

ECurrentNetworkInfoChangeCancel

Cancel a pending CurrentNetworkInfoChange request.

EGetCurrentNetworkNameCancel

Cancel a pending GetCurrentNetworkName request.

EGetOperatorNameCancel

Cancel a pending GetOperatorName request.

EGetCallForwardingStatusCancel

Cancel a pending GetCallForwardingStatus request.

EGetCallBarringStatusCancel

Cancel a pending GetCallBarringStatus request.

EGetCallWaitingStatusCancel

Cancel a pending GetCallWaitingStatus request.

EGetIdentityServiceStatusCancel

Cancel a pending GetIdentityServiceStatus request.

EFaxLineStatusChangeCancel

Cancel a pending FaxLineStatusChange request.

EDataLineStatusChangeCancel

Cancel a pending DataLineStatusChange request.

Enum TFlightModeStatus

The flight mode status.

Enumerators

EFlightModeOff = 0

Flight mode is off.

EFlightModeOn = 1

Flight mode is on.

Enum TIccLock

Pin 1/Pin 2 security

Enumerators

ELockPin1

Lock PIN1 on the ICC.

ELockPin2

Lock PIN2 on the ICC.

Enum TIccLockSetting

Setting of the ICC lock.

Enumerators

ELockSetUnknown

The setting of the lock is unknown.

ELockSetEnabled

Lock is enabled, and is available for use. Its status may be CTelephony::EStatusLocked, CTelephony::EStatusUnlocked, or CTelephony::EStatusBlocked.

The associated security code will be required to unlock the lock the next time the lock's status is CTelephony::EStatusLocked.

ELockSetDisabled

Lock is disabled. It is not available for use, so its status is always CTelephony::EStatusUnlocked.

Enum TIccLockStatus

Status of an ICC lock.

Enumerators

EStatusLockUnknown

The status of the lock is unknown.

EStatusLocked

Lock is closed.

User can not access functionality governed by this lock until user correctly enters associated security code.

EStatusUnlocked

Lock is open.

User can access functionality governed by this lock

EStatusBlocked

Lock is blocked.

User should enter the unblocking code to be able to switch back to the unlocked mode. Blocking is enabled after a number of unsuccessful attempts to verify PIN1/2.

Enum TIdentityService

Phone ID services.

Enumerators

EIdServiceUnspecified

The identity service is unspecified.

EIdServiceCallerPresentation

The caller's ID is presented to the called party.

EIdServiceCallerRestriction

The caller's ID is restricted to the called party.

Enum TIdentityServiceStatus

Service status of the Phone ID services.

Enumerators

EIdServiceActivePermanent

The interrogated identity service is provisioned and permanently active.

EIdServiceActiveDefaultRestricted

The interrogated identity service is provisioned and active. By default, the number is restricted unless overridden by the user.

EIdServiceActiveDefaultAllowed

The interrogated identity service is provisioned and active. By default, the number is displayed unless specifically restricted by the user.

EIdServiceNotProvisioned

The interrogated identity service is not provisioned.

EIdServiceUnknown

The status of the interrogated Identity service is unknown.

Enum TMobileCallControlCaps

Mobile call control capabilities.

Enumerators

KCapsHold = 0x00000200

Indicates that this call can be put on hold. This implies that the call is currently active and that there is no other held call.

KCapsResume = 0x00000400

Indicates that this call can be resumed. This implies that the call is currently on hold and that there is no other active call.

KCapsSwap = 0x00000800

Indicates that this call's state can be swapped to the opposite state. This implies that this call is either active or held. There may be another call in the opposite state and if this is the case then both calls will be simultaneously swapped to their opposite state.

Enum TNetworkAccess

The access technology that the network is based on.

Enumerators

ENetworkAccessUnknown

This is used when there is no network activity and therefore no RAT active.

ENetworkAccessGsm

The access technology is GSM.

ENetworkAccessGsmCompact

The access technology is GSM COMPACT. However GSM COMPACT systems which use GSM frequency bands but with the CBPCCH broadcast channel are considered as a separate access technology from GSM.

ENetworkAccessUtran

The access technology is UTRAN (UMTS Network).

Enum TNetworkBandInfo

Mobile phone network band information.

Enumerators

EBandUnknown

The current band and band class is unknown.

E800BandA

The network operates at 800MHz on Band A.

E800BandB

The network operates at 800MHz on Band B.

E800BandC

The network operates at 800MHz on Band C.

E1900BandA

The network operates at 1900MHz on Band A.

E1900BandB

The network operates at 1900MHz on Band B.

E1900BandC

The network operates at 1900MHz on Band C.

E1900BandD

The network operates at 1900MHz on Band D.

E1900BandE

The network operates at 1900MHz on Band E.

E1900BandF

The network operates at 1900MHz on Band F.

Enum TNetworkMode

Defines Current Network Modes.

Enumerators

ENetworkModeUnknown

Network mode is unknown.

ENetworkModeUnregistered

Mobile device is not registered.

ENetworkModeGsm

GSM/GPRS or DCS1800 network.

ENetworkModeAmps

AMPS network.

ENetworkModeCdma95

CDMA (IS-95) network.

ENetworkModeCdma2000

CDMA (cdma2000) network.

ENetworkModeWcdma

WCDMA (UTRA Frequency Division Duplex (FDD)) network.

ENetworkModeTdcdma

TD-CDMA (UTRA Time Division Duplex (TDD)) network.

Enum TNetworkStatus

Phone network status.

Enumerators

ENetworkStatusUnknown

Status is unknown.

ENetworkStatusAvailable

A network that the mobile device is allowed to register to.

ENetworkStatusCurrent

Currently registered network.

ENetworkStatusForbidden

A network that the ME is not allowed to register to.

Enum TNotificationEvent

Notification events

Enumerators

EFlightModeChange

Register interest for receiving a notification for flight mode changes.

New flight mode returned in a CTelephony::TFlightModeV1Pckg, a packaged CTelephony::TFlightModeV1.

Pass CancelAsync() CTelephony::EFlightModeChangeCancel to cancel.

capability

None CTelephony::NotifyChange

EIndicatorChange

Register interest for receiving a notification for phone indicator changes.

New indicators returned in a CTelephony::TIndicatorV1Pckg, a packaged CTelephony::TIndicatorV1.

Pass CancelAsync() CTelephony::EIndicatorChangeCancel to cancel.

capability

None CTelephony::NotifyChange

EBatteryInfoChange

Register interest for receiving a notification for Battery information changes.

New Battery information returned in a CTelephony::TBatteryInfoV1Pckg, a packaged CTelephony::TBatteryInfoV1.

Pass CancelAsync() CTelephony::EBatteryInfoChangeCancel to cancel.

capability

None CTelephony::NotifyChange

ESignalStrengthChange

Register interest for receiving a notification for Signal Strength changes.

New Signal Strength returned in a CTelephony::TSignalStrengthV1Pckg, a packaged CTelephony::TSignalStrengthV1.

Pass CancelAsync() CTelephony::ESignalStrengthChangeCancel to cancel.

capability

None CTelephony::NotifyChange

EPin1LockInfoChange

Register interest for receiving a notification for Icc Pin1 Lock Information changes.

New Icc Pin1 Lock Information returned in a CTelephony::TIccLockInfoV1Pckg, a packaged CTelephony::TIccLockInfoV1.

Pass CancelAsync() CTelephony::EPin1LockInfoChangeCancel to cancel.

capability

ReadDeviceData CTelephony::NotifyChange

EPin2LockInfoChange

Register interest for receiving a notification for Icc Pin2 Lock Information changes.

New Icc Pin2 Lock Information returned in a CTelephony::TIccLockInfoV1Pckg, a packaged CTelephony::TIccLockInfoV1.

Pass CancelAsync() CTelephony::EPin2LockInfoChangeCancel to cancel.

capability

ReadDeviceData CTelephony::NotifyChange

EVoiceLineStatusChange

Register interest for receiving a notification for Voice Line Status changes.

New Voice Line Status returned in a CTelephony::TCallStatusV1Pckg, a packaged CTelephony::TCallStatusV1.

Pass CancelAsync() CTelephony::EVoiceLineStatusChangeCancel to cancel.

capability

None CTelephony::NotifyChange

EOwnedCall1StatusChange

Register interest for receiving a notification for owned Call 1 Status changes.

New Call 1 Status returned in a CTelephony::TCallStatusV1Pckg, a packaged CTelephony::TCallStatusV1.

Pass CancelAsync() CTelephony::EOwnedCall1StatusChangeCancel to cancel.

capability

None CTelephony::NotifyChange

EOwnedCall2StatusChange

Register interest for receiving a notification for owned Call 2 Status changes.

New Call 2 Status returned in a CTelephony::TCallStatusV1Pckg, a packaged CTelephony::TCallStatusV1.

Pass CancelAsync() CTelephony::EOwnedCall2StatusChangeCancel to cancel.

capability

None CTelephony::NotifyChange

EOwnedCall1RemotePartyInfoChange

Register interest for receiving a notification for Call 1 Remote Party Info changes.

New Call 1 Remote Party Info returned in a CTelephony::TRemotePartyInfoV1Pckg, a packaged CTelephony::TRemotePartyInfoV1.

Pass CancelAsync() CTelephony::EOwnedCall1RemotePartyInfoChangeCancel to cancel.

capability

ReadUserData CTelephony::NotifyChange

EOwnedCall2RemotePartyInfoChange

Register interest for receiving a notification for Call 2 Remote Party Info changes.

New Call 2 Remote Party Info returned in a CTelephony::TRemotePartyInfoV1Pckg, a packaged CTelephony::TRemotePartyInfoV1.

Pass CancelAsync() CTelephony::EOwnedCall2RemotePartyInfoChangeCancel to cancel.

capability

ReadUserData CTelephony::NotifyChange

ENetworkRegistrationStatusChange

Register interest for receiving a notification for Network registration status changes.

New Network registration status returned in a CTelephony::TNetworkRegistrationV1Pckg, a packaged CTelephony::TNetworkRegistrationV1.

Pass CancelAsync() CTelephony::ENetworkRegistrationStatusChangeCancel to cancel.

capability

None CTelephony::NotifyChange

ECurrentNetworkInfoChange

Register interest for receiving a notification for Network information changes.

New Network information returned in a CTelephony::TNetworkInfoV1Pckg, a packaged CTelephony::TNetworkInfoV1.

Pass CancelAsync() CTelephony::ECurrentNetworkInfoChangeCancel to cancel.

capability

ReadDeviceData CTelephony::NotifyChange

EFaxLineStatusChange

Register interest for receiving a notification for Fax Line Status changes.

New Fax Line Status returned in a CTelephony::TCallStatusV1Pckg, a packaged CTelephony::TCallStatusV1.

Pass CancelAsync() CTelephony::EFaxLineStatusChangeCancel to cancel.

capability

None CTelephony::NotifyChange

EDataLineStatusChange

Register interest for receiving a notification for Data Line Status changes.

New Data Line Status returned in a CTelephony::TCallStatusV1Pckg, a packaged CTelephony::TCallStatusV1.

Pass CancelAsync() CTelephony::EDataLineStatusChangeCancel to cancel.

capability

None CTelephony::NotifyChange

Enum TPhoneIndicators

The mobile phone indicators.

Enumerators

KIndChargerConnected = 0x00000001

If bit-flag is set to '1' indicates that the battery charger is connected to the phone. If bit-flag is set to '0' indicates that the battery charger is disconnected

For capability: If bit-flag is set to '0' indicates that the battery charger indication reporting is unavailable.

KIndNetworkAvailable = 0x00000002

If bit-flag is set to '1' indicates that network service is available. If bit-flag is set to '0' indicates that network service is unavailable

For capability: If bit-flag is set to '0' indicates that the network availability indication reporting is unavailable.

KIndCallInProgress = 0x00000004

If bit-flag is set to '1' indicates that a call is in progress. If set to '0' indicates that a call is not in progress

For capability: If bit-flag is set to '0' indicates that the call is in progress indication reporting is unavailable.

Enum TPhoneLine

Line types

Enumerators

EVoiceLine

Voice line.

EDataLine

Data line.

EFaxLine

Fax line.

Enum TPhoneNetworkSecurity

Enumerated network security types.

Enumerators

ECipheringOff

The encryption level is NONE.

ECipheringGSM

The encryption level is GSM.(standard encryption algorithms for 2nd Generation Mobile networks).

ECipheringWCDMA

The encryption level is WDCMA.(standard encryption algorithms for 3rd Generation Mobile networks).

Enum TRegistrationStatus

The registration status of the phone.

Enumerators

ERegistrationUnknown

Registration status is unknown.

ENotRegisteredNoService

Not registered. The ME can not detect any other networks and is not currently searching a new operator to register to.

ENotRegisteredEmergencyOnly

Not registered. The ME can detect other networks on which it is possible to make emergency calls only.

ENotRegisteredSearching

Not registered, but the ME is currently searching a new operator to register to.

ERegisteredBusy

Registered, network busy.

ERegisteredOnHomeNetwork

Registered on home network.

ERegistrationDenied

Registration denied.

ERegisteredRoaming

Registered, roaming.

Enum TServiceGroup

Service group identifier.

Enumerators

EVoiceService

Voice service group

EFaxService

Fax service group

EDataService

Data service group

Enum TSupplServiceStatus

Supplementary Service status.

Enumerators

EStatusActive

The supplementary service is currently active and operative.

ENotActive

The supplementary service is currently deactivated or quiescent.

ENotProvisioned

In GSM/WCDMA mode, the supplementary service is not provisioned. In CDMA mode, this value has no meaning.

ENotAvailable

In GSM/WCDMA mode, the supplementary service is not available in serving network. In CDMA mode, the supplementary service is not available in the phone.

EUnknown

The phone can not determine supplementary service status.

Enum TTelNumberNPI

Number Plan Indicator.

Enumerators

EUnknownNumberingPlan = 0

User or the network has no knowledge of the numbering plan.

EIsdnNumberPlan = 1

ISDN/telephony numbering plan.

EDataNumberPlan = 3

Data numbering plan.

ETelexNumberPlan = 4

Telex numbering plan.

EServiceCentreSpecificPlan1 = 5

Service centre specific plan used to indicate a numbering plan specific to external Short Message entities attached to the SMSC.

EServiceCentreSpecificPlan2 = 6

Service centre specific plan used to indicate a numbering plan specific to external Short Message entities attached to the SMSC.

ENationalNumberPlan = 8

National numbering plan.

EPrivateNumberPlan = 9

Private numbering plan.

EERMESNumberPlan = 10

ERMES numbering plan.

Enum TTelNumberTON

Address types.

Enumerators

EUnknownNumber

User or the network has no knowledge of the type of number.

EInternationalNumber

International number.

ENationalNumber

National number.

ENetworkSpecificNumber

Administration/service number specific to the serving network, e.g. used to access an operator.

ESubscriberNumber

Subscriber number.

EAlphanumericNumber

Alphanumeric number.

EAbbreviatedNumber

Abbreviated number.

Member Type Definitions Documentation

Typedef TBatteryInfoV1Pckg

typedef TPckg< TBatteryInfoV1 >TBatteryInfoV1Pckg

A typedef'd packaged CTelephony::TBatteryInfoV1 for passing through a generic API method.

Typedef TCallBarringSupplServicesV1Pckg

typedef TPckg< TCallBarringSupplServicesV1 >TCallBarringSupplServicesV1Pckg

A typedef'd packaged CTelephony::TCallBarringSupplServicesV1 for passing through a generic API method.

Typedef TCallCapsV1Pckg

typedef TPckg< TCallCapsV1 >TCallCapsV1Pckg

A typedef'd packaged CTelephony::TCallParamsV1 for passing through a generic API method.

Typedef TCallForwardingSupplServicesV1Pckg

typedef TPckg< TCallForwardingSupplServicesV1 >TCallForwardingSupplServicesV1Pckg

A typedef'd packaged CTelephony::TCallForwardingSupplServicesV1 for passing through a generic API method.

Typedef TCallInfoV1Pckg

typedef TPckg< TCallInfoV1 >TCallInfoV1Pckg

A typedef'd packaged CTelephony::TCallInfoV1 for passing through a generic API method.

Typedef TCallParamsV1Pckg

typedef TPckg< TCallParamsV1 >TCallParamsV1Pckg

A typedef'd packaged CTelephony::TCallParamsV1 for passing through a generic API method.

Typedef TCallSelectionV1Pckg

typedef TPckg< TCallSelectionV1 >TCallSelectionV1Pckg

A typedef'd packaged CTelephony::TCallSelectionV1 for passing through a generic API method.

Typedef TCallStatusV1Pckg

typedef TPckg< TCallStatusV1 >TCallStatusV1Pckg

A typedef'd packaged CTelephony::TCallStatusV1 for passing through a generic API method.

Typedef TCallWaitingSupplServicesV1Pckg

typedef TPckg< TCallWaitingSupplServicesV1 >TCallWaitingSupplServicesV1Pckg

A typedef'd packaged CTelephony::TCallWaitingSupplServicesV1 for passing through a generic API method.

Typedef TFlightModeV1Pckg

typedef TPckg< TFlightModeV1 >TFlightModeV1Pckg

A typedef'd packaged CTelephony::TFlightModeV1 for passing through a generic API method.

Typedef TIccLockInfoV1Pckg

typedef TPckg< TIccLockInfoV1 >TIccLockInfoV1Pckg

A typedef'd packaged CTelephony::TIccLockInfoV1 for passing through a generic API method.

Typedef TIdentityServiceV1Pckg

typedef TPckg< TIdentityServiceV1 >TIdentityServiceV1Pckg

A typedef'd packaged CTelephony::TIdentityServiceV1 for passing through a generic API method.

Typedef TIndicatorV1Pckg

typedef TPckg< TIndicatorV1 >TIndicatorV1Pckg

A typedef'd packaged CTelephony::TIndicatorV1 for passing through a generic API method.

Typedef TNetworkInfoV1Pckg

typedef TPckg< TNetworkInfoV1 >TNetworkInfoV1Pckg

A typedef'd packaged CTelephony::TNetworkInfoV1 for passing through a generic API method.

Typedef TNetworkInfoV2Pckg

typedef TPckg< TNetworkInfoV2 >TNetworkInfoV2Pckg

A typedef'd packaged CTelephony::TNetworkInfoV2 for passing through a generic API method.

Typedef TNetworkNameV1Pckg

typedef TPckg< TNetworkNameV1 >TNetworkNameV1Pckg

A typedef'd packaged CTelephony::TNetworkNameV1 for passing through a generic API method.

Typedef TNetworkNameV2Pckg

typedef TPckg< TNetworkNameV2 >TNetworkNameV2Pckg

A typedef'd packaged CTelephony::TNetworkNameV2 for passing through a generic API method. TNetworkNameV2 differs from Version 1 in that the length of iNetworkName is 20 rather than 16.

Typedef TNetworkRegistrationV1Pckg

typedef TPckg< TNetworkRegistrationV1 >TNetworkRegistrationV1Pckg

A typedef'd packaged CTelephony::TNetworkRegistrationV1 for passing through a generic API method.

Typedef TOperatorNameV1Pckg

typedef TPckg< TOperatorNameV1 >TOperatorNameV1Pckg

A typedef'd packaged CTelephony::TOperatorNameV1 for passing through a generic API method.

Typedef TPhoneIdV1Pckg

typedef TPckg< TPhoneIdV1 >TPhoneIdV1Pckg

A typedef'd packaged CTelephony::TPhoneIdV1 for passing through a generic API method

Typedef TRemotePartyInfoV1Pckg

typedef TPckg< TRemotePartyInfoV1 >TRemotePartyInfoV1Pckg

A typedef'd packaged CTelephony::TRemotePartyInfoV1 for passing through a generic API method.

Typedef TSignalStrengthV1Pckg

typedef TPckg< TSignalStrengthV1 >TSignalStrengthV1Pckg

A typedef'd packaged CTelephony::TSignalStrengthV1 for passing through a generic API method.

Typedef TSubscriberIdV1Pckg

typedef TPckg< TSubscriberIdV1 >TSubscriberIdV1Pckg

A typedef'd packaged CTelephony::TSubscriberIdV1 for passing through a generic API method.

Typedef TTelNumber

typedef TBuf< KMaxTelNumberSize >TTelNumber

A typedef to hold the telephone number.

Member Data Documentation

CTelephonyFunctions * iTelephonyFunctions

CTelephonyFunctions *iTelephonyFunctions[private]