Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]



Location: Etel3rdParty.h
Link against: etel3rdparty.lib

Class CTelephony

class CTelephony : public CBase;

Description

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.

Derivation

Members

Defined in CTelephony:
AnswerIncomingCall(), CancelAsync(), CancelEstablishDataCall(), CancelReceiveDataCall(), DialNewCall(), E1900BandA, E1900BandB, E1900BandC, E1900BandD, E1900BandE, E1900BandF, E800BandA, E800BandB, E800BandC, EAbbreviatedNumber, EActiveCall, EAlphanumericNumber, EAnswerIncomingCallCancel, EBandUnknown, EBarAllIncoming, EBarAllOutgoing, EBarIncomingRoaming, EBarOutgoingInternational, EBarOutgoingInternationalExHC, EBatteryConnectedButExternallyPowered, EBatteryInfoChange, EBatteryInfoChangeCancel, ECallForwardingBusy, ECallForwardingNoReply, ECallForwardingNotReachable, ECallForwardingUnconditional, ECipheringGSM, ECipheringOff, ECipheringWCDMA, ECurrentNetworkInfoChange, ECurrentNetworkInfoChangeCancel, EDataLine, EDataLineStatusChange, EDataLineStatusChangeCancel, EDataNumberPlan, EDataService, EDialNewCallCancel, EDirectionUnknown, EDontSendMyId, EERMESNumberPlan, EFaxLine, EFaxLineStatusChange, EFaxLineStatusChangeCancel, EFaxService, EFlightModeChange, EFlightModeChangeCancel, EFlightModeOff, EFlightModeOn, EGetBatteryInfoCancel, EGetCallBarringStatusCancel, EGetCallForwardingStatusCancel, EGetCallWaitingStatusCancel, EGetCurrentNetworkInfoCancel, EGetCurrentNetworkNameCancel, EGetFlightModeCancel, EGetIdentityServiceStatusCancel, EGetIndicatorCancel, EGetLockInfoCancel, EGetNetworkRegistrationStatusCancel, EGetOperatorNameCancel, EGetPhoneIdCancel, EGetSignalStrengthCancel, EGetSubscriberIdCancel, EHangupCancel, EHeldCall, EHoldCancel, EISVCall1, EISVCall2, EISVMaxNumOfCalls, EIdRestrictDefault, EIdServiceActiveDefaultAllowed, EIdServiceActiveDefaultRestricted, EIdServiceActivePermanent, EIdServiceCallerPresentation, EIdServiceCallerRestriction, EIdServiceNotProvisioned, EIdServiceUnknown, EIdServiceUnspecified, EInProgressCall, EIndicatorChange, EIndicatorChangeCancel, EInternationalNumber, EIsdnNumberPlan, ELockPin1, ELockPin2, ELockSetDisabled, ELockSetEnabled, ELockSetUnknown, EMobileOriginated, EMobileTerminated, ENationalNumber, ENationalNumberPlan, ENetworkAccessGsm, ENetworkAccessGsmCompact, ENetworkAccessUnknown, ENetworkAccessUtran, ENetworkModeAmps, ENetworkModeCdma2000, ENetworkModeCdma95, ENetworkModeGsm, ENetworkModeTdcdma, ENetworkModeUnknown, ENetworkModeUnregistered, ENetworkModeWcdma, ENetworkRegistrationStatusChange, ENetworkRegistrationStatusChangeCancel, ENetworkSpecificNumber, ENetworkStatusAvailable, ENetworkStatusCurrent, ENetworkStatusForbidden, ENetworkStatusUnknown, ENoBatteryConnected, ENotActive, ENotAvailable, ENotProvisioned, ENotRegisteredEmergencyOnly, ENotRegisteredNoService, ENotRegisteredSearching, EOwnedCall1RemotePartyInfoChange, EOwnedCall1RemotePartyInfoChangeCancel, EOwnedCall1StatusChange, EOwnedCall1StatusChangeCancel, EOwnedCall2RemotePartyInfoChange, EOwnedCall2RemotePartyInfoChangeCancel, EOwnedCall2StatusChange, EOwnedCall2StatusChangeCancel, EPin1LockInfoChange, EPin1LockInfoChangeCancel, EPin2LockInfoChange, EPin2LockInfoChangeCancel, EPowerFault, EPowerStatusUnknown, EPoweredByBattery, EPrivateNumberPlan, ERegisteredBusy, ERegisteredOnHomeNetwork, ERegisteredRoaming, ERegistrationDenied, ERegistrationUnknown, ERemoteIdentityAvailable, ERemoteIdentitySuppressed, ERemoteIdentityUnknown, EResumeCancel, ESendDTMFTonesCancel, ESendMyId, EServiceCentreSpecificPlan1, EServiceCentreSpecificPlan2, ESignalStrengthChange, ESignalStrengthChangeCancel, EStatusActive, EStatusAnswering, EStatusBlocked, EStatusConnected, EStatusConnecting, EStatusDialling, EStatusDisconnecting, EStatusHold, EStatusIdle, EStatusLockUnknown, EStatusLocked, EStatusReconnectPending, EStatusRinging, EStatusTransferAlerting, EStatusTransferring, EStatusUnknown, EStatusUnlocked, ESubscriberNumber, ESwapCancel, ETelexNumberPlan, EUnknown, EUnknownNumber, EUnknownNumberingPlan, EVoiceLine, EVoiceLineStatusChange, EVoiceLineStatusChangeCancel, EVoiceService, EstablishDataCall(), EstablishDataCall(), FindDeviceStatus(), GetBatteryInfo(), GetCallBarringStatus(), GetCallDynamicCaps(), GetCallForwardingStatus(), GetCallInfo(), GetCallStatus(), GetCallWaitingStatus(), GetCurrentNetworkInfo(), GetCurrentNetworkName(), GetFlightMode(), GetIdentityServiceStatus(), GetIndicator(), GetLineStatus(), GetLockInfo(), GetNetworkRegistrationStatus(), GetOperatorName(), GetPhoneId(), GetSignalStrength(), GetSubscriberId(), Hangup(), Hold(), KCallingNameSize, KCapsHold, KCapsResume, KCapsSwap, KEtelISVV1, KEtelISVV2, KIMSISize, KIndCallInProgress, KIndChargerConnected, KIndNetworkAvailable, KMaxTelNumberSize, KNetworkCountryCodeSize, KNetworkDisplayTagSize, KNetworkIdentitySize, KNetworkLongNameSize, KNetworkLongNameSizeV2, KNetworkShortNameSize, KNetworkShortNameSizeV2, KPhoneManufacturerIdSize, KPhoneModelIdSize, KPhoneSerialNumberSize, NewL(), NewLC(), NotifyChange(), ReceiveDataCall(), ReceiveDataCall(), Resume(), SendDTMFTones(), Swap(), TBatteryInfoV1, TBatteryInfoV1Pckg, TBatteryStatus, TCallBarringCondition, TCallBarringSupplServicesV1, TCallBarringSupplServicesV1Pckg, TCallCapsV1, TCallCapsV1Pckg, TCallDirection, TCallForwardingCondition, TCallForwardingSupplServicesV1, TCallForwardingSupplServicesV1Pckg, TCallId, TCallInfoV1, TCallInfoV1Pckg, TCallParamsV1, TCallParamsV1Pckg, TCallRemoteIdentityStatus, TCallSelect, TCallSelectionV1, TCallSelectionV1Pckg, TCallStatus, TCallStatusV1, TCallStatusV1Pckg, TCallWaitingSupplServicesV1, TCallWaitingSupplServicesV1Pckg, TCallerIdentityRestrict, TCancellationRequest, TEtelISVType, TFlightModeStatus, TFlightModeV1, TFlightModeV1Pckg, TIccLock, TIccLockInfoV1, TIccLockInfoV1Pckg, TIccLockSetting, TIccLockStatus, TIdentityService, TIdentityServiceStatus, TIdentityServiceV1, TIdentityServiceV1Pckg, TIndicatorV1, TIndicatorV1Pckg, TMobileCallControlCaps, TNetworkAccess, TNetworkBandInfo, TNetworkInfoV1, TNetworkInfoV1Pckg, TNetworkInfoV2, TNetworkInfoV2Pckg, TNetworkMode, TNetworkNameV1, TNetworkNameV1Pckg, TNetworkNameV2, TNetworkNameV2Pckg, TNetworkRegistrationV1, TNetworkRegistrationV1Pckg, TNetworkStatus, TNotificationEvent, TOperatorNameV1, TOperatorNameV1Pckg, TPhoneIdV1, TPhoneIdV1Pckg, TPhoneIndicators, TPhoneLine, TPhoneNetworkSecurity, TRegistrationStatus, TRemotePartyInfoV1, TRemotePartyInfoV1Pckg, TServiceGroup, TSignalStrengthV1, TSignalStrengthV1Pckg, TSubscriberIdV1, TSubscriberIdV1Pckg, TSupplServiceStatus, TTelAddress, TTelNumber, TTelNumberNPI, TTelNumberTON, TerminateDataCall(), Version(), anonymous, anonymous, anonymous, anonymous, anonymous, anonymous, anonymous, anonymous, anonymous, anonymous, anonymous, anonymous, anonymous, anonymous

Inherited from CBase:
Delete(), Extension_(), operator new()


Construction and destruction


NewLC()

static IMPORT_C CTelephony *NewLC();

Description

Constructs a CTelephony object.

A pointer to this object is left on the CleanupStack.

The returned pointer is typically assigned to a pointer-variable on the stack.

Return value

CTelephony *

Pointer to a newly created CTelephony object.


NewL()

static IMPORT_C CTelephony *NewL();

Description

Constructs a CTelephony object.

No pointer to this object is left on the CleanupStack.

The returned pointer is typically assigned to a pointer-variable stored in the Heap.

Return value

CTelephony *

Pointer to a newly created CTelephony object.

[Top]


Member functions


Version()

inline TVersion Version() const;

Description

Get current CTelephony version

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

Return value

TVersion

TVersion object, see E32STD.H


GetPhoneId()

Capability: Illegal

IMPORT_C void GetPhoneId(TRequestStatus &aReqStatus, TDes8 &aId) const;

Description

Retrieves the model information and unique identification of the mobile device.

This is an asynchronous method. Upon successful completion of the request the manufacturer name, model and serial number (IMEI or ESN) are returned back to the client via the aDes argument.

Parameters

TRequestStatus &aReqStatus

Returns the result code after the asynchronous call completes. Pass CTelephony::CancelAsync() CTelephony::EGetPhoneIdCancel to cancel.

TDes8 &aId

Contains a CTelephony::TPhoneIdV1Pckg, a packaged version of the CTelephony::TPhoneIdV1 class which is filled on completion.


GetSubscriberId()

Capability: ReadDeviceData

IMPORT_C void GetSubscriberId(TRequestStatus &aReqStatus, TDes8 &aId) const;

Description

Retrieves information about the mobile device's current subscriber. This will normally identify the SIM card on GSM and WCDMA networks or the R-UIM card on CDMA networks. It is independent of the phone.

This is an asynchronous method. Upon successful completion of the request the serial number of the SIM or R-UIM card is returned back to the client via the aDes argument.

Parameters

TRequestStatus &aReqStatus

Returns the result code after the asynchronous call completes. Pass CTelephony::CancelAsync() CTelephony::EGetSubscriberIdCancel to cancel.

TDes8 &aId

Contains a CTelephony::TSubscriberIdV1Pckg, a packaged version of the CTelephony::TSubscriberIdV1 class which is filled on completion.


GetFlightMode()

Capability: Illegal

IMPORT_C void GetFlightMode(TRequestStatus &aReqStatus, TDes8 &aMode) const;

Description

Retrieves the current flight mode status. The flight mode is returned via the aMode argument.

This is an asynchronous method.

If the flight mode status is set to "off" then all network-related requests are disabled.

If the phone’s software does not support this feature then this method returns KErrNotSupported.

Parameters

TRequestStatus &aReqStatus

Returns the result code after the asynchronous call completes. Pass CTelephony::CancelAsync() CTelephony::EGetFlightModeCancel to cancel.

TDes8 &aMode

Contains a CTelephony::TFlightModeV1Pckg, a packaged version of the CTelephony::TFlightModeV1 class which is filled on completion.


GetIndicator()

Capability: Illegal

IMPORT_C void GetIndicator(TRequestStatus &aReqStatus, TDes8 &aIndicator) const;

Description

Retrieves the battery charging indicator, the network availability indicator and call-in-progress indicator.

This is an asynchronous method. The method returns two flags for each indicator: the first is a capability flag; it says whether the indicator is valid. The second flag is the indicator itself.

For instance, two flags are returned for the battery charging indicator. The capability flag is only set if the phone can detect when a charger is connected. The indicator flag is only set when a charger is actually connected. The indicator flag is only valid when the capability flag is set.

Six flags, two for each indicator, are returned by this method in the packaged aIndicator parameter.

Parameters

TRequestStatus &aReqStatus

Returns the result code after the asynchronous call completes. Pass CTelephony::CancelAsync() CTelephony::EGetBatteryInfoCancel to cancel.

TDes8 &aIndicator

Contains a CTelephony::TIndicatorV1Pckg, a packaged version of the CTelephony::TIndicatorV1 class which is filled on completion.

See also:


GetBatteryInfo()

Capability: Illegal

IMPORT_C void GetBatteryInfo(TRequestStatus &aReqStatus, TDes8 &aBatteryInfo) const;

Description

Retrieves the status and charge level of the phone battery.

This is an asynchronous method. Upon successful completion of the request the battery information is returned via the packaged aDes argument.

Parameters

TRequestStatus &aReqStatus

Returns the result code after the asynchronous call completes. Pass CTelephony::CancelAsync() CTelephony::EGetBatteryInfoCancel to cancel.

TDes8 &aBatteryInfo

Contains a CTelephony::TBatteryInfoV1Pckg, a packaged version of the CTelephony::TBatteryInfoV1 class which is filled on completion.


GetSignalStrength()

Capability: Illegal

IMPORT_C void GetSignalStrength(TRequestStatus &aReqStatus, TDes8 &aSignalStrength) const;

Description

Retrieves the phone's current signal strength via the aDes argument.

This is an asynchronous method.

If signal strength information is not supported by the phone the method will return KErrNotSupported. If no signal strength information is currently available the method will return KErrNotFound.

This functionality is not available when the phone is in "flight" mode.

Parameters

TRequestStatus &aReqStatus

Returns the result code after the asynchronous call completes. Pass CTelephony::CancelAsync() CTelephony::EGetSignalStrengthCancel to cancel.

TDes8 &aSignalStrength

Contains a CTelephony::TSignalStrengthV1Pckg, a packaged version of the CTelephony::TSignalStrengthV1 class which is filled on completion.


GetLockInfo()

Capability: ReadDeviceData

IMPORT_C void GetLockInfo(TRequestStatus &aReqStatus, const TIccLock &aLock, TDes8 &aLockInfo) const;

Description

Some phones allow users to lock them to prevent unauthorised use. Typically, a code must be entered to unlock the phone.

This method retrieves the state and status of ICC locks PIN1/2. The client selects the lock that it wishes to retrieve the status and state of.

This is an asynchronous method. Upon successful completion of the request the PIN1/2 information is returned via the aDes argument.

Note that this member function does not concern the keypad locks. Nor does it concern the lock that the networks use to prevent a phone from being used on other networks.

Parameters

TRequestStatus &aReqStatus

Returns the result code after the asynchronous call completes. Pass CTelephony::CancelAsync() CTelephony::EGetLockInfoCancel to cancel.

const TIccLock &aLock

Lock to interrogate. Either Pin1 or Pin2.

TDes8 &aLockInfo

Contains a CTelephony::TIccLockInfoV1Pckg, a packaged version of the CTelephony::TIccLockInfoV1 class which is filled on completion.


SendDTMFTones()

Capability: NetworkServices

IMPORT_C void SendDTMFTones(TRequestStatus &aReqStatus, const TDesC &aTones) const;

Description

Transmits DTMF tones across all the current active voice calls.

This is an asynchronous method. The request completes when the tones have been sent. The string of DTMF characters is passed via the aTones parameter. The string of DTMF characters can contain one or more DTMF tone(s).

This functionality is not available when the phone is in "flight" mode.

Parameters

TRequestStatus &aReqStatus

Returns the result code after the asynchronous call completes. use CTelephony::ESendDTMFTonesCancel to cancel.

const TDesC &aTones

String containing tones to transmit. It can contain one or more occurance of the numbers 0 to 9, * and #.


GetLineStatus()

Capability: Illegal

IMPORT_C TInt GetLineStatus(const TPhoneLine &aLine, TDes8 &aStatus) const;

Description

Retrieves the status of the line selected by the aLine argument. The current status of the selected line is returned to the client via the aStatus argument.

When only one call is in progress, the line status is identical to the status of the call.

When two calls are in progress (one active and one on hold) then the status of the most "active" (connected and active or in progress) call is returned.

This functionality is not available when the phone is in "flight" mode.

Parameters

const TPhoneLine &aLine

Identifier to line from which status is to be retrieved.

TDes8 &aStatus

On completion contains the current line status in a CTelephony::TCallStatusV1Pckg, a packaged version of CTelephony::TCallStatusV1.

Return value

TInt

KErrNone if successful, otherwise another of the system-wide error codes.


GetCallInfo()

Capability: ReadUserData

IMPORT_C TInt GetCallInfo(TDes8 &aCallSelect, TDes8 &aCallInfo, TDes8 &aRemoteInfo) const;

Description

Retrieves information about the call selected by the aCallSelect argument.

If a call with the appropriate status is not available, then KErrNotFound is returned. Upon successful completion the call information will be returned via the aCallInfo and aRemoteCallInfo arguments.

This functionality should be used after a notification of an incoming call, notification of line status change to dialling, or notification of remote party info change. Notification is requested with CTelephony::NotifyChange(). After completion of the notification the client should immediately request information about the call.

Parameters

TDes8 &aCallSelect

Identifies the call for which information is retrieved.

TDes8 &aCallInfo

Contains CTelephony::TCallInfoV1Pckg, the packaged CTelephony::TCallInfoV1 parameter class which is filled on completion.

TDes8 &aRemoteInfo

Contains CTelephony::TRemotePartyInfoV1Pckg, the packaged CTelephony::TRemotePartyInfoV1 parameter class which is filled on completion.

Return value

TInt

KErrNone if successful, otherwise another of the system-wide error codes.


DialNewCall()

Capability: NetworkServices

IMPORT_C void DialNewCall(TRequestStatus &aStatus, TDes8 &aCallParams, const TTelNumber &aTelNumber, TCallId &aCallId, const TPhoneLine aLine=EVoiceLine) const;

Description

Initiates a new call.

The client specifies the telephone number via the aTelNumber argument and the desired call parameters via the aCallParams argument.

This is an asynchronous method. After successful completion of the dial request a call identifier is returned back to the client via the aCallId argument. The call identifier is needed to hold, resume, swap, and terminate the call. It is also needed to monitor the status of the call.

This functionality is not available when the phone is in "flight" mode.

Parameters

TRequestStatus &aStatus

Returns the result code after the asynchronous call completes. Pass CTelephony::CancelAsync() CTelephony::EDialNewCallCancel to cancel.

TDes8 &aCallParams

The call parameters used by the TSY. Pass a CTelephony::TCallParamsV1Pckg, a packaged CTelephony::TCallParamsV1.

const TTelNumber &aTelNumber

Telephone number to dial.

TCallId &aCallId

Upon completion, contains the call identifier.

const TPhoneLine aLine

Line on which call can be made. Currently, only voice calls are supported.

See also:


GetCallDynamicCaps()

Capability: Illegal

IMPORT_C TInt GetCallDynamicCaps(const TCallId &aCallId, TDes8 &aCallCaps) const;

Description

Retrieves the dynamic call capabilities for calls you dialled or answered with CTelephony.

The client specifies the call ID via the aCallId argument. Upon successful retrieval the call control capabilities (Hold, Resume and Swap) are returned via the aCaps argument.

This functionality is not available when the phone is in "flight" mode.

Parameters

const TCallId &aCallId

Call ID, as returned by CTelephony::DialNewCall() or CTelephony::AnswerIncomingCall().

TDes8 &aCallCaps

On completion contains a CTelephony::TCallCapsV1Pckg, a packaged CTelephony::TCallCapsV1 containing the call's dynamic capabilities.

Return value

TInt

KErrNone if successful, otherwise another of the system-wide error codes.


GetCallStatus()

Capability: Illegal

IMPORT_C TInt GetCallStatus(const TCallId &aCallId, TDes8 &aCallStatus) const;

Description

Retrieves the status of the selected call specified by the aCallId argument.

The current status of the selected call is returned to the client via the aStatus argument. GetCallStatus is available only for the voice line.

This functionality is not available when the phone is in "flight" mode.

Parameters

const TCallId &aCallId

Call ID, as returned by CTelephony::DialNewCall() or CTelephony::AnswerIncomingCall().

TDes8 &aCallStatus

On completion contains a CTelephony::TCallStatusV1Pckg, a packaged CTelephony::TCallStatusV1 containing the call status.

Return value

TInt

KErrNone if successful, otherwise another of the system-wide error codes.

See also:


Hold()

Capability: NetworkServices

IMPORT_C void Hold(TRequestStatus &aReqStatus, const TCallId &aCallId) const;

Description

Places a call on hold. This is only for calls you dialled or answered with CTelephony.

The call's dynamic capabilities must allow the Hold operation for this call to have successful completion of this request; see CTelephony::GetCallDynamicCaps().

This is an asynchronous method. Upon successful completion of Hold, line and call status might be affected by this operation. Hold is only available for the voice line.

This functionality is not available when the phone is in "flight" mode.

Parameters

TRequestStatus &aReqStatus

Returns the result code after the asynchronous call completes. Pass CTelephony::CancelAsync() CTelephony::EHoldCancel to cancel.

const TCallId &aCallId

Call ID, as returned by CTelephony::DialNewCall() or CTelephony::AnswerIncomingCall().

See also:


Resume()

Capability: NetworkServices

IMPORT_C void Resume(TRequestStatus &aReqStatus, const TCallId &aCallId) const;

Description

Resumes a held call. This is only for calls you dialled or answered with CTelephony. The client specifies the call ID via the aCallId argument.

The call's dynamic capabilities must allow the Resume operation for this call to have successful completion of this request; see CTelephony::GetCallDynamicCaps().

This is an asynchronous method. Upon successful completion of Resume, line and call status might be affected by this operation. Resume is only available for the voice line.

This functionality is not available when the phone is in "flight" mode.

Parameters

TRequestStatus &aReqStatus

Returns the result code after the asynchronous call completes. Pass CTelephony::CancelAsync() CTelephony::EResumeCancel to cancel.

const TCallId &aCallId

Call ID, as returned by CTelephony::DialNewCall() or CTelephony::AnswerIncomingCall().

See also:


Swap()

Capability: NetworkServices

IMPORT_C void Swap(TRequestStatus &aReqStatus, const TCallId &aCallId1, const TCallId &aCallId2) const;

Description

Swaps calls. This is only for calls you dialled or answered with CTelephony.

Swap is possible only if both calls are owned by this ISV application. The client specifies the call ids via the aCallId1 and aCallId2 arguments.

This is an asynchronous method.

The calls' dynamic capabilities must allow the Swap operation for this call to have successful completion of this request; see CTelephony::GetCallDynamicCaps().

Swap is only available for the voice line.

This functionality is not available when the phone is in "flight" mode.

Parameters

TRequestStatus &aReqStatus

Returns the result code after the asynchronous call completes. Pass CTelephony::CancelAsync() CTelephony::ESwapCancel to cancel.

const TCallId &aCallId1

ID of a call, as returned by CTelephony::DialNewCall() or CTelephony::AnswerIncomingCall().

const TCallId &aCallId2

ID of another call, as returned by CTelephony::DialNewCall() or CTelephony::AnswerIncomingCall().

See also:


Hangup()

Capability: NetworkServices

IMPORT_C void Hangup(TRequestStatus &aReqStatus, const TCallId &aCallId) const;

Description

Hangs up a call. This is only for calls you dialled or answered with CTelephony.

The client specifies the call ID via the aCallId argument.

This is an asynchronous method. Upon successful completion of Hangup, the line and call status might be affected. Hangup is available only for the voice line.

This functionality is not available when the phone is in "flight" mode.

Parameters

TRequestStatus &aReqStatus

Returns the result code after the asynchronous call completes. Pass CTelephony::CancelAsync() CTelephony::EHangupCancel to cancel.

const TCallId &aCallId

Call ID, as returned by CTelephony::DialNewCall() or CTelephony::AnswerIncomingCall().

See also:


AnswerIncomingCall()

Capability: NetworkServices

IMPORT_C void AnswerIncomingCall(TRequestStatus &aReqStatus, TCallId &aCallId, const TPhoneLine aLine=EVoiceLine) const;

Description

Answers an incoming new voice call. Fax and data calls cannot be answered.

Answering an incoming call is possible only when the voice line status is ringing (CTelephony::EStatusRinging) and RLine::NotifyIncomingCall has completed.

This is an asynchronous method. Upon successful completion of AnswerIncomingCall() a call ID is returned to the client via the aCallId argument. The call identifier is needed to hold, resume, swap, and terminate the call. It is also needed to monitor the status of the call.

This functionality is not available when the phone is in "flight" mode.

Parameters

TRequestStatus &aReqStatus

Returns the result code after the asynchronous call completes. Pass CTelephony::CancelAsync() CTelephony::EAnswerIncomingCallCancel to cancel

TCallId &aCallId

On completion, contains the call ID.

const TPhoneLine aLine

Line from which the answer request will attempted. Currently, only the voice line is supported.

See also:


GetNetworkRegistrationStatus()

Capability: Illegal

IMPORT_C void GetNetworkRegistrationStatus(TRequestStatus &aReqStatus, TDes8 &aStatus) const;

Description

Retrieves the current network registration status.

This is an asynchronous method. Upon successful completion of this request the registration status is returned via the aDes argument.

This functionality is not available when the phone is in "flight" mode.

Parameters

TRequestStatus &aReqStatus

Returns the result code after the asynchronous call completes. Pass CTelephony::CancelAsync() CTelephony::EGetNetworkRegistrationStatusCancel to cancel.

TDes8 &aStatus

Contains a CTelephony::TNetworkRegistrationV1Pckg, a packaged version of the CTelephony::TNetworkRegistrationV1 class which is filled on completion.


GetCurrentNetworkInfo()

Capability: ReadDeviceData because Cell ID is retrieved from the platform.

IMPORT_C void GetCurrentNetworkInfo(TRequestStatus &aReqStatus, TDes8 &aNetworkInfo) const;

Description

Retrieves over-the-air network information about the currently registered mobile network.

This is an asynchronous method. Upon successful completion the network information is returned via the aDes argument.

This functionality is not available when the phone is in "flight" mode.

Parameters

TRequestStatus &aReqStatus

Returns the result code after the asynchronous call completes. Pass CTelephony::CancelAsync() CTelephony::EGetCurrentNetworkInfoCancel to cancel. KErrAccessDenied is given to this request status if the device is in flight mode.

TDes8 &aNetworkInfo

Contains a CTelephony::TNetworkInfoV1Pckg, a packaged version of the CTelephony::TNetworkInfoV1 class which is filled on completion.


GetCurrentNetworkName()

Capability: Illegal

IMPORT_C void GetCurrentNetworkName(TRequestStatus &aReqStatus, TDes8 &aNetworkName) const;

Description

Retrieves ICC-stored information about the (preferred) name of the currently registered mobile network.

This is an asynchronous method. Upon successful completion the retrieved network name(s) is returned via the aDes argument.

This functionality is not available when the phone is in "flight" mode.

Cancellation of the request can be achieved by passing CTelephony::EGetCurrentNetworkNameCancel to the function CTelephony::CancelAsync().

Note: This information is only available on GSM/WCDMA networks.

Parameters

TRequestStatus &aReqStatus

Returns the result code after the asynchronous call completes. KErrAccessDenied will be returned if the phone is in flight mode.

TDes8 &aNetworkName

Contains a CTelephony::TNetworkNameV1Pckg, a packaged version of the CTelephony::TNetworkNameV1 class which is filled on completion.


GetOperatorName()

Capability: Illegal

IMPORT_C void GetOperatorName(TRequestStatus &aReqStatus, TDes8 &aOperator) const;

Description

Retrieve ICC stored information about the currently registered mobile network. Upon successful completion the retrieved network name(s) is returned via the aOperator argument.

This functionality is not available when the phone is in "flight" mode.

Cancellation of the request can be achieved by passing CTelephony::EGetOperatorNameCancel to the function CTelephony::CancelAsync().

Note: This information is only available on GSM/WCDMA networks.

Parameters

TRequestStatus &aReqStatus

Returns the result code after the asynchronous call completes. KErrAccessDenied will be returned if the phone is in flight mode.

TDes8 &aOperator

Contains a CTelephony::TOperatorNameV1Pckg, a packaged version of the CTelephony::TOperatorNameV1 class which is filled on completion.


GetCallForwardingStatus()

Capability: NetworkServices
Capability: ReadDeviceData

IMPORT_C void GetCallForwardingStatus(TRequestStatus &aRequestStatus, const TCallForwardingCondition aCondition, TDes8 &aSSInfo, const TServiceGroup aServiceGroup=EVoiceService) const;

Description

Interrogates the current status of the call forwarding services.

Specify the condition for enquiry via the aCondition argument.

This is an asynchronous method. Upon successful completion the status information is returned via the aSSInfo argument. Support is available only for the voice line.

This functionality is not available when the phone is in "flight" mode.

Note: This information is only available on GSM/WCDMA networks.

Parameters

TRequestStatus &aRequestStatus

Returns the result code after the asynchronous call completes. Pass CTelephony::CancelAsync() CTelephony::EGetCallForwardingStatusCancel to cancel.

const TCallForwardingCondition aCondition

Call forwarding condition to be interrogated.

TDes8 &aSSInfo

Contains a CTelephony::TCallForwardingSupplServicesV1Pckg, a packaged version of the CTelephony::TCallForwardingSupplServicesV1 class which is filled on completion.

const TServiceGroup aServiceGroup

Service group to be interrogated.


GetCallBarringStatus()

Capability: NetworkServices
Capability: ReadDeviceData

IMPORT_C void GetCallBarringStatus(TRequestStatus &aRequestStatus, const TCallBarringCondition aCondition, TDes8 &aSSInfo, const TServiceGroup aServiceGroup=EVoiceService) const;

Description

Interrogate the current status of the call barring services.

Specify the condition for enquiry via the aCondition argument. Upon successful completion the status information is returned via the aSSInfo argument. Support is available only for the voice line.

This functionality is not available when the phone is in "flight" mode.

Parameters

TRequestStatus &aRequestStatus

Returns the result code after the asynchronous call completes. Pass CTelephony::CancelAsync() CTelephony::EGetCallBarringStatusCancel to cancel.

const TCallBarringCondition aCondition

Call barring condition to be interrogated.

TDes8 &aSSInfo

Contains a CTelephony::TCallBarringSupplServicesV1Pckg, a packaged version of the CTelephony::TCallBarringSupplServicesV1 class which is filled on completion.

const TServiceGroup aServiceGroup

Service group to be interrogated.


GetCallWaitingStatus()

Capability: NetworkServices
Capability: ReadDeviceData

IMPORT_C void GetCallWaitingStatus(TRequestStatus &aRequestStatus, TDes8 &aSSInfo, const TServiceGroup aServiceGroup=EVoiceService) const;

Description

Interrogate the current status of the call waiting services.

Upon successful completion the status information is returned via the aSSInfo argument. Support is available only for the voice line.

This functionality is not available when the phone is in "flight" mode.

Parameters

TRequestStatus &aRequestStatus

Returns the result code after the asynchronous call completes. Pass CCTelephony::ancelAsync() CTelephony::EGetCallWaitingStatusCancel to cancel.

TDes8 &aSSInfo

Contains a CTelephony::TCallWaitingSupplServicesV1Pckg, a packaged version of the CTelephony::TCallWaitingSupplServicesV1 class which is filled on completion.

const TServiceGroup aServiceGroup

Service group to be interrogated.


GetIdentityServiceStatus()

Capability: Illegal

IMPORT_C void GetIdentityServiceStatus(TRequestStatus &aReqStatus, const TIdentityService &aService, TDes8 &aStatus) const;

Description

Interrogate the current status of the identity services.

Specify the service for enquiry via the aService argument. Upon successful completion the service status is returned via the aStatus argument.

This functionality is not available when the phone is in "flight" mode.

Note: This information is only available on GSM/WCDMA networks.

Parameters

TRequestStatus &aReqStatus

Returns the result code after the asynchronous call completes. Pass CTelephony::CancelAsync() CTelephony::EGetIdentityServiceStatusCancel to cancel.

const TIdentityService &aService

TDes8 &aStatus

Contains a CTelephony::TIdentityServiceV1Pckg, a packaged version of the CTelephony::TIdentityServiceV1 class which is filled on completion.


CancelAsync()

Capability: Illegal

IMPORT_C TInt CancelAsync(TCancellationRequest aCancel) const;

Description

Cancels an outstanding asynchronous request.

The result of the cancellation request will be reflected through the request status of the pending request. A status of KErrCancel denotes that the request has been safely cancelled.

Parameters

TCancellationRequest aCancel

Canncellation code of request to be cancelled.

Return value

TInt


NotifyChange()

Capability: Dependent This function depends on the TNotificationEvent value passed to it.

IMPORT_C void NotifyChange(TRequestStatus &aReqStatus, const TNotificationEvent &aEvent, TDes8 &aDes) const;

Description

Registers interest in receiving change notifications for events.

Specify the event that you are interested with the aEvent parameter.

Each event is associated with a packaged class. Pass an instance of this class to this method. Then, when the event occurs, information relating to the event is written into it. The description of CTelephony::TNotificationEvent tells you the information class for each event.

This is an asynchronous method. Notification can be cancelled using the cancellation codes specified in CTelephony::TNotificationEvent. Pass the appropriate code to CTelephony::CancelAsync() to cancel the notification request.

Parameters

TRequestStatus &aReqStatus

Returns the result code after the asynchronous call completes.

const TNotificationEvent &aEvent

Event on which change notification is requested.

TDes8 &aDes

Packaged information class. On completion, information relating to the event is written into this class. Until then, this class's data is not valid.


FindDeviceStatus()

IMPORT_C TInt FindDeviceStatus(TInt &aCallStatus);

Description

This method is no longer supported.

Parameters

TInt &aCallStatus

Return value

TInt

KErrNotSupported


EstablishDataCall()

IMPORT_C TInt EstablishDataCall(TInt &aDataChannel, const TDesC &aDialNumber);

Description

This method is no longer supported.

It was used to establish a circuit-switched data call, but support was removed as functionality was no longer required by licensees. Developers should consider using GPRS via RConnection and RSocket for data functionality instead.

Parameters

TInt &aDataChannel

const TDesC &aDialNumber

Return value

TInt

KErrNotSupported


EstablishDataCall()

IMPORT_C void EstablishDataCall(TRequestStatus &aRequestStatus, TInt &aDataChannel, const TDesC &aDialNumber);

Description

This method is no longer supported.

It was used to establish a circuit-switched data call, but support was removed as functionality was no longer required by licensees. Developers should consider using GPRS via RConnection and RSocket for data functionality instead.

Parameters

TRequestStatus &aRequestStatus

TInt &aDataChannel

const TDesC &aDialNumber


TerminateDataCall()

IMPORT_C TInt TerminateDataCall();

Description

This method is no longer supported.

It was used to terminate a circuit-switched data call, but support was removed as functionality was no longer required by licensees. Developers should consider using GPRS via RConnection and RSocket for data functionality instead.

Return value

TInt

KErrNotSupported


ReceiveDataCall()

IMPORT_C TInt ReceiveDataCall(TInt &aDataChannel);

Description

This method is no longer supported.

It was used to receive a circuit-switched data call, but support was removed as functionality was no longer required by licensees. Developers should consider using GPRS via RConnection and RSocket for data functionality instead.

Parameters

TInt &aDataChannel

Return value

TInt

KErrNotSupported


ReceiveDataCall()

IMPORT_C void ReceiveDataCall(TRequestStatus &aRequestStatus, TInt &aDataChannel);

Description

This method is no longer supported.

It was used to receive a circuit-switched data call, but support was removed as functionality was no longer required by licensees. Developers should consider using GPRS via RConnection and RSocket for data functionality instead.

Parameters

TRequestStatus &aRequestStatus

TInt &aDataChannel


CancelEstablishDataCall()

IMPORT_C void CancelEstablishDataCall();

Description

This method is no longer supported.

It was used to cancel an outstanding request to establish a circuit-switched data call, but support was removed as functionality was no longer required by licensees. Developers should consider using GPRS via RConnection and RSocket for data functionality instead.


CancelReceiveDataCall()

IMPORT_C void CancelReceiveDataCall();

Description

This method is no longer supported.

It was used to cancel an outstanding request to receive a circuit-switched data call, but support was removed as functionality was no longer required by licensees. Developers should consider using GPRS via RConnection and RSocket for data functionality instead.

[Top]


Member classes


Class TEtelISVType

class TEtelISVType;

Description

Specifies which version of an API parameter a client has used. For most ETel ISV v1.0/2.0 parameters this will equal KETelISV1.

Members

Defined in CTelephony::TEtelISVType:
VersionId(), iVersionId

Member functions


VersionId()

IMPORT_C TInt VersionId() const;

Description

Default constructor.

Return value

TInt

Member data


iVersionId

protected: TInt iVersionId;

Description


Class TTelAddress

class TTelAddress;

Description

Defines API abstraction of a mobile telephone number.

Members

Defined in CTelephony::TTelAddress:
TTelAddress(), iNumberPlan, iTelNumber, iTypeOfNumber

Construction and destruction


TTelAddress()

IMPORT_C TTelAddress();

Description

Default constructor.

Member data


iTypeOfNumber

TTelNumberTON iTypeOfNumber;

Description

Type of number.


iNumberPlan

TTelNumberNPI iNumberPlan;

Description

Number plan.


iTelNumber

TTelNumber iTelNumber;

Description

Telephone number.


Class TPhoneIdV1

class TPhoneIdV1 : public CTelephony::TEtelISVType;

Description

Defines the mobile phone identity.

Derivation

Members

Defined in CTelephony::TPhoneIdV1:
TPhoneIdV1(), iManufacturer, iModel, iSerialNumber

Inherited from CTelephony::TEtelISVType:
VersionId(), iVersionId

Construction and destruction


TPhoneIdV1()

IMPORT_C TPhoneIdV1();

Description

Default constructor.

Member data


iManufacturer

TBuf< KPhoneManufacturerIdSize > iManufacturer;

Description

Phone manufacturer identification, in character string format.


iModel

TBuf< KPhoneModelIdSize > iModel;

Description

Phone model identification, in character string format.


iSerialNumber

TBuf< KPhoneSerialNumberSize > iSerialNumber;

Description

Phone serial number (IMEI or ESN), in character string format.


Class TSubscriberIdV1

class TSubscriberIdV1 : public CTelephony::TEtelISVType;

Description

Defines the Subscriber (IMSI) Id

Derivation

Members

Defined in CTelephony::TSubscriberIdV1:
TSubscriberIdV1(), iSubscriberId

Inherited from CTelephony::TEtelISVType:
VersionId(), iVersionId

Construction and destruction


TSubscriberIdV1()

IMPORT_C TSubscriberIdV1();

Description

Member data


iSubscriberId

TBuf< KIMSISize > iSubscriberId;

Description

IMSI identifier.


Class TFlightModeV1

class TFlightModeV1 : public CTelephony::TEtelISVType;

Description

Defines the flight mode status.

Derivation

Members

Defined in CTelephony::TFlightModeV1:
TFlightModeV1(), iFlightModeStatus

Inherited from CTelephony::TEtelISVType:
VersionId(), iVersionId

Construction and destruction


TFlightModeV1()

IMPORT_C TFlightModeV1();

Description

Default constructor.

Member data


iFlightModeStatus

TFlightModeStatus iFlightModeStatus;

Description

The current status of the mobile radio interface and bluetooth.


Class TIndicatorV1

class TIndicatorV1 : public CTelephony::TEtelISVType;

Description

Contains indicator parameters:

Derivation

Members

Defined in CTelephony::TIndicatorV1:
TIndicatorV1(), iCapabilities, iIndicator

Inherited from CTelephony::TEtelISVType:
VersionId(), iVersionId

See also:

Construction and destruction


TIndicatorV1()

IMPORT_C TIndicatorV1();

Description

Default constructor.

Member data


iIndicator

TUint32 iIndicator;

Description

The value of the indicators. It is the sum of CTelephony::TPhoneIndicators constants.


iCapabilities

TUint32 iCapabilities;

Description

The supported (available) indicator capability that the telephony service module offers. It is the sum of CTelephony::TPhoneIndicators constants.


Class TBatteryInfoV1

class TBatteryInfoV1 : public CTelephony::TEtelISVType;

Description

Defines contents of the battery status of the phone.

Derivation

Members

Defined in CTelephony::TBatteryInfoV1:
TBatteryInfoV1(), iChargeLevel, iStatus

Inherited from CTelephony::TEtelISVType:
VersionId(), iVersionId

Construction and destruction


TBatteryInfoV1()

IMPORT_C TBatteryInfoV1();

Description

Default constructor.

Member data


iStatus

TBatteryStatus iStatus;

Description

The power and battery status.


iChargeLevel

TUint iChargeLevel;

Description

The percentage battery charge level.


Class TSignalStrengthV1

class TSignalStrengthV1 : public CTelephony::TEtelISVType;

Description

Defines the phone's current signal strength.

Derivation

Members

Defined in CTelephony::TSignalStrengthV1:
TSignalStrengthV1(), iBar, iSignalStrength

Inherited from CTelephony::TEtelISVType:
VersionId(), iVersionId

Construction and destruction


TSignalStrengthV1()

IMPORT_C TSignalStrengthV1();

Description

Default constructor.

Member data


iSignalStrength

TInt32 iSignalStrength;

Description

The value of signal strength.


iBar

TInt8 iBar;

Description

The absolute number of signal "bars" that the phone should display.


Class TIccLockInfoV1

class TIccLockInfoV1 : public CTelephony::TEtelISVType;

Description

Defines the Icc Lock parameters.

Derivation

Members

Defined in CTelephony::TIccLockInfoV1:
TIccLockInfoV1(), iSetting, iStatus

Inherited from CTelephony::TEtelISVType:
VersionId(), iVersionId

Construction and destruction


TIccLockInfoV1()

IMPORT_C TIccLockInfoV1();

Description

Default constructor.

Member data


iStatus

TIccLockStatus iStatus;

Description

The current status of the lock.


iSetting

TIccLockSetting iSetting;

Description

The current availability of the lock. When not available (i.e. the lock is not in use) then its status will always be CTelephony::EStatusUnlocked.


Class TCallStatusV1

class TCallStatusV1 : public CTelephony::TEtelISVType;

Description

Defines the current call or line status.

Derivation

Members

Defined in CTelephony::TCallStatusV1:
TCallStatusV1(), iStatus

Inherited from CTelephony::TEtelISVType:
VersionId(), iVersionId

Construction and destruction


TCallStatusV1()

IMPORT_C TCallStatusV1();

Description

Default constructor.

Member data


iStatus

TCallStatus iStatus;

Description

The current call or line status.


Class TCallSelectionV1

class TCallSelectionV1 : public CTelephony::TEtelISVType;

Description

Defines parameters to select a call, determined by its call state for a specific line

Derivation

Members

Defined in CTelephony::TCallSelectionV1:
TCallSelectionV1(), iLine, iSelect

Inherited from CTelephony::TEtelISVType:
VersionId(), iVersionId

Construction and destruction


TCallSelectionV1()

IMPORT_C TCallSelectionV1();

Description

Default constructor.

Member data


iLine

TPhoneLine iLine;

Description

The current phone line selection.


iSelect

TCallSelect iSelect;

Description

The current call selection.


Class TCallInfoV1

class TCallInfoV1 : public CTelephony::TEtelISVType;

Description

Defines general information about a call.

Derivation

Members

Defined in CTelephony::TCallInfoV1:
TCallInfoV1(), iCallId, iDialledParty, iDuration, iExitCode, iSecurity, iStartTime, iStatus

Inherited from CTelephony::TEtelISVType:
VersionId(), iVersionId

Construction and destruction


TCallInfoV1()

IMPORT_C TCallInfoV1();

Description

Default constructor.

Member data


iStatus

TCallStatus iStatus;

Description

The current status of the call.


iStartTime

TDateTime iStartTime;

Description

The time & date the call started.


iDuration

TTimeIntervalSeconds iDuration;

Description

The current duration of the call.


iDialledParty

TTelAddress iDialledParty;

Description

The original number (including DTMF) dialled for an outgoing call.


iExitCode

TInt iExitCode;

Description

The reason for termination of a finished call. Will equal KErrNone if the call ended normally and KErrNotFound if the call has not ended.


iSecurity

TPhoneNetworkSecurity iSecurity;

Description

This attribute indicates whether Ciphering Status of a Call is enabled or disabled.


iCallId

TInt iCallId;

Description

The call id of an ISV application owned call. For calls not owned by this ISV application (-1) is returned.


Class TRemotePartyInfoV1

class TRemotePartyInfoV1 : public CTelephony::TEtelISVType;

Description

Derivation

Members

Defined in CTelephony::TRemotePartyInfoV1:
TRemotePartyInfoV1(), iCallingName, iDirection, iRemoteIdStatus, iRemoteNumber

Inherited from CTelephony::TEtelISVType:
VersionId(), iVersionId

Construction and destruction


TRemotePartyInfoV1()

IMPORT_C TRemotePartyInfoV1();

Description

Defines information about the remote party of a call.

Member data


iRemoteIdStatus

TCallRemoteIdentityStatus iRemoteIdStatus;

Description

Indicates whether the remote party information in the rest of this structure is valid or not.


iCallingName

TBuf< KCallingNameSize > iCallingName;

Description

Calling party name available through the CNAP supplementary service (if provisioned).


iRemoteNumber

TTelAddress iRemoteNumber;

Description

The phone number of the remote party if available.


iDirection

TCallDirection iDirection;

Description

The direction of the call and hence the role of the remote party. i.e. if the call is mobile originated then the remote party is the called party. Whereas if the call is mobile terminated then the remote party is the calling party.


Class TCallParamsV1

class TCallParamsV1 : public CTelephony::TEtelISVType;

Description

Derivation

Members

Defined in CTelephony::TCallParamsV1:
TCallParamsV1(), iIdRestrict

Inherited from CTelephony::TEtelISVType:
VersionId(), iVersionId

Construction and destruction


TCallParamsV1()

IMPORT_C TCallParamsV1();

Description

Defines the parameters used for set-up of a call.

Member data


iIdRestrict

TCallerIdentityRestrict iIdRestrict;

Description

Call Id restriction setting to be used for this call.


Class TCallCapsV1

class TCallCapsV1 : public CTelephony::TEtelISVType;

Description

Derivation

Members

Defined in CTelephony::TCallCapsV1:
TCallCapsV1(), iControlCaps

Inherited from CTelephony::TEtelISVType:
VersionId(), iVersionId

Construction and destruction


TCallCapsV1()

IMPORT_C TCallCapsV1();

Description

Defines the dynamic capabilities of a call.

See also:

Member data


iControlCaps

TUint32 iControlCaps;

Description

Call Id restriction setting to be used for this call. It is the sum of CTelephony::TMobileCallControlCaps constants.


Class TNetworkRegistrationV1

class TNetworkRegistrationV1 : public CTelephony::TEtelISVType;

Description

Defines the current network registration status

Derivation

Members

Defined in CTelephony::TNetworkRegistrationV1:
TNetworkRegistrationV1(), iRegStatus

Inherited from CTelephony::TEtelISVType:
VersionId(), iVersionId

Construction and destruction


TNetworkRegistrationV1()

IMPORT_C TNetworkRegistrationV1();

Description

Default constructor.

Member data


iRegStatus

TRegistrationStatus iRegStatus;

Description

The current network registration status.


Class TNetworkInfoV1

class TNetworkInfoV1 : public CTelephony::TEtelISVType;

Description

Defines information related to a mobile phone network.

Derivation

Members

Defined in CTelephony::TNetworkInfoV1:
TNetworkInfoV1(), iAccess, iAreaKnown, iBandInfo, iCdmaSID, iCellId, iCountryCode, iDisplayTag, iLocationAreaCode, iLongName, iMode, iNetworkId, iShortName, iStatus

Inherited from CTelephony::TEtelISVType:
VersionId(), iVersionId

See also:

Construction and destruction


TNetworkInfoV1()

IMPORT_C TNetworkInfoV1();

Description

Default constructor.

Member data


iMode

TNetworkMode iMode;

Description

Mode of the network.


iStatus

TNetworkStatus iStatus;

Description

Status of the network


iCountryCode

TBuf< KNetworkCountryCodeSize > iCountryCode;

Description

The MCC of the network.


iNetworkId

TBuf< KNetworkIdentitySize > iNetworkId;

Description

The network identity (NID in CDMA and MNC in GSM).


iDisplayTag

TBuf< KNetworkDisplayTagSize > iDisplayTag;

Description

The alpha-tag displayed when this is the serving network.


iShortName

TBuf< KNetworkShortNameSize > iShortName;

Description

On GSM/WCDMA networks, the short name (up to 8 characters) of the network operator.


iBandInfo

TNetworkBandInfo iBandInfo;

Description

On CDMA networks, the band and band class of the CDMA network operator.


iCdmaSID

TBuf< KNetworkIdentitySize > iCdmaSID;

Description

On CDMA networks, the system identity (SID) of the CDMA or AMPS network


iLongName

TBuf< KNetworkLongNameSize > iLongName;

Description

On GSM/WCDMA networks, the long name (up to 16 characters) of the network operator.


iAccess

TNetworkAccess iAccess;

Description

On GSM/WCDMA networks, the type of network access.


iAreaKnown

TBool iAreaKnown;

Description

On GSM/WCDMA networks, boolean indicating whether the location area is known.


iLocationAreaCode

TUint iLocationAreaCode;

Description

On GSM/WCDMA networks, the location area code. Only valid when iAccess is true.


iCellId

TUint iCellId;

Description

On GSM/WCDMA networks, the cell identity code. Only valid when iAccess is true.


Class TNetworkNameV1

class TNetworkNameV1 : public CTelephony::TEtelISVType;

Description

Defines the name network name.

Note: This information is only available on GSM/WCDMA networks.

Derivation

Members

Defined in CTelephony::TNetworkNameV1:
TNetworkNameV1(), iNetworkName

Inherited from CTelephony::TEtelISVType:
VersionId(), iVersionId

Construction and destruction


TNetworkNameV1()

IMPORT_C TNetworkNameV1();

Description

Default constructor.

Member data


iNetworkName

TBuf< KNetworkLongNameSize > iNetworkName;

Description

The displayed name (up to 16 characters) of the network provider.


Class TOperatorNameV1

class TOperatorNameV1 : public CTelephony::TEtelISVType;

Description

Defines the current operator.

Note: This information is only available on GSM/WCDMA networks.

Derivation

Members

Defined in CTelephony::TOperatorNameV1:
TOperatorNameV1(), iOperatorName

Inherited from CTelephony::TEtelISVType:
VersionId(), iVersionId

Construction and destruction


TOperatorNameV1()

IMPORT_C TOperatorNameV1();

Description

Default constructor.

Member data


iOperatorName

TBuf< KNetworkLongNameSize > iOperatorName;

Description

The displayed name (up to 16 characters) of the network operator.


Class TNetworkInfoV2

class TNetworkInfoV2 : public CTelephony::TEtelISVType;

Description

Defines information related to a mobile phone network. TNetworkInfoV2 differs from Version 1 (TNetworkInfoV1) in that the length of iShortName and iLongName are 10 and 20 respectively (rather than 8 and 16).

TNetworkInfoV2 should be used in preference to TNetworkInfoV1. The short and long network names provided in this V2 class are of the length supplied by the platform. The V1 class's names will be truncated if the platform provides names longer than its limits.

Derivation

Members

Defined in CTelephony::TNetworkInfoV2:
TNetworkInfoV2(), iAccess, iAreaKnown, iBandInfo, iCdmaSID, iCellId, iCountryCode, iDisplayTag, iLocationAreaCode, iLongName, iMode, iNetworkId, iShortName, iStatus

Inherited from CTelephony::TEtelISVType:
VersionId(), iVersionId

Construction and destruction


TNetworkInfoV2()

IMPORT_C TNetworkInfoV2();

Description

Default constructor.

Member data


iMode

TNetworkMode iMode;

Description

Mode of the network.


iStatus

TNetworkStatus iStatus;

Description

Status of the network.


iCountryCode

TBuf< KNetworkCountryCodeSize > iCountryCode;

Description

The MCC of the network.


iNetworkId

TBuf< KNetworkIdentitySize > iNetworkId;

Description

The network identity (NID in CDMA and MNC in GSM).


iDisplayTag

TBuf< KNetworkDisplayTagSize > iDisplayTag;

Description

The alpha-tag displayed when this is the serving network.


iShortName

TBuf< KNetworkShortNameSizeV2 > iShortName;

Description

On GSM/WCDMA networks, the short name (up to 10 characters) of the network operator.


iBandInfo

TNetworkBandInfo iBandInfo;

Description

On CDMA networks, the band and band class of the CDMA network operator.


iCdmaSID

TBuf< KNetworkIdentitySize > iCdmaSID;

Description

On CDMA networks, the system identity (SID) of the CDMA or AMPS network.


iLongName

TBuf< KNetworkLongNameSizeV2 > iLongName;

Description

On GSM/WCDMA networks, the long name (up to 20 characters) of the network operator.


iAccess

TNetworkAccess iAccess;

Description

On GSM/WCDMA networks, the type of network access.


iAreaKnown

TBool iAreaKnown;

Description

On GSM/WCDMA networks, boolean indicating whether the location area is known.


iLocationAreaCode

TUint iLocationAreaCode;

Description

On GSM/WCDMA networks, the location area code. Only valid when iAccess is true.


iCellId

TUint iCellId;

Description

On GSM/WCDMA networks, the cell identity code. Only valid when iAccess is true.


Class TNetworkNameV2

class TNetworkNameV2 : public CTelephony::TEtelISVType;

Description

Defines the name network name. TNetworkNameV2 differs from Version 1 (TNetworkNameV1) in that the length of iNetworkName is 20 (rather than 16).

TNetworkNameV2 should be used in preference to TNetworkNameV1. The network name provided in this V2 class is of the length supplied by the platform. The V1 class' network name will be truncated if the platform provides a name longer than V1 name's limit.

Note: This information is only available on GSM/WCDMA networks.

Derivation

Members

Defined in CTelephony::TNetworkNameV2:
TNetworkNameV2(), iNetworkName

Inherited from CTelephony::TEtelISVType:
VersionId(), iVersionId

Construction and destruction


TNetworkNameV2()

IMPORT_C TNetworkNameV2();

Description

Default constructor.

Member data


iNetworkName

TBuf< KNetworkLongNameSizeV2 > iNetworkName;

Description

The displayed name (up to 20 characters) of the network provider.


Class TCallForwardingSupplServicesV1

class TCallForwardingSupplServicesV1 : public CTelephony::TEtelISVType;

Description

Defines information about the call forwarding service.

Note: This information is only available on GSM/WCDMA networks.

Derivation

Members

Defined in CTelephony::TCallForwardingSupplServicesV1:
TCallForwardingSupplServicesV1(), iCallForwarding, iCallForwardingCondition

Inherited from CTelephony::TEtelISVType:
VersionId(), iVersionId

Construction and destruction


TCallForwardingSupplServicesV1()

IMPORT_C TCallForwardingSupplServicesV1();

Description

Default constructor.

Member data


iCallForwarding

TSupplServiceStatus iCallForwarding;

Description

The status of the call forwarding supplementary service. It applies to the condition in iCallForwardingCondition and to the line specified to CTelephony::GetCallForwardingStatus().


iCallForwardingCondition

TCallForwardingCondition iCallForwardingCondition;

Description

The provisioned call forwarding condition to which iCallForwarding applies.


Class TCallBarringSupplServicesV1

class TCallBarringSupplServicesV1 : public CTelephony::TEtelISVType;

Description

Defines information about the call barring service.

Derivation

Members

Defined in CTelephony::TCallBarringSupplServicesV1:
TCallBarringSupplServicesV1(), iCallBarring, iCallBarringCondition

Inherited from CTelephony::TEtelISVType:
VersionId(), iVersionId

Construction and destruction


TCallBarringSupplServicesV1()

IMPORT_C TCallBarringSupplServicesV1();

Description

Default constructor.

Member data


iCallBarring

TSupplServiceStatus iCallBarring;

Description

The status of the call barring supplementary service. It applies to the condition in iCallBarringCondition and to the service group specified to CTelephony::GetCallBarringStatus().


iCallBarringCondition

TCallBarringCondition iCallBarringCondition;

Description

The provisioned call barring condition to which iCallBarring applies.


Class TCallWaitingSupplServicesV1

class TCallWaitingSupplServicesV1 : public CTelephony::TEtelISVType;

Description

Defines information about the call waiting service.

Derivation

Members

Defined in CTelephony::TCallWaitingSupplServicesV1:
TCallWaitingSupplServicesV1(), iCallWaiting

Inherited from CTelephony::TEtelISVType:
VersionId(), iVersionId

Construction and destruction


TCallWaitingSupplServicesV1()

IMPORT_C TCallWaitingSupplServicesV1();

Description

Default constructor.

Member data


iCallWaiting

TSupplServiceStatus iCallWaiting;

Description

The status of the call waiting supplementary service for the service group specified to CTelephony::GetCallWaitingStatus().


Class TIdentityServiceV1

class TIdentityServiceV1 : public CTelephony::TEtelISVType;

Description

Defines the call identity service status.

Note: This information is only available on GSM/WCDMA networks.

Derivation

Members

Defined in CTelephony::TIdentityServiceV1:
TIdentityServiceV1(), iIdentityStatus

Inherited from CTelephony::TEtelISVType:
VersionId(), iVersionId

Construction and destruction


TIdentityServiceV1()

IMPORT_C TIdentityServiceV1();

Description

Default constructor.

Member data


iIdentityStatus

TIdentityServiceStatus iIdentityStatus;

Description

The status of the call identity service.

[Top]


Member enumerations


Enum anonymous

n/a

Description

Unique parameter class identifier.

KEtelISVV1

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

KEtelISVV2

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


Enum anonymous

n/a

Description

The maximum number of digits allowed in a multimode telephone number.

KMaxTelNumberSize


Enum TTelNumberTON

TTelNumberTON

Description

Address types.

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.


Enum TTelNumberNPI

TTelNumberNPI

Description

Number Plan Indicator.

EUnknownNumberingPlan

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

EIsdnNumberPlan

ISDN/telephony numbering plan.

EDataNumberPlan

Data numbering plan.

ETelexNumberPlan

Telex numbering plan.

EServiceCentreSpecificPlan1

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

EServiceCentreSpecificPlan2

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

ENationalNumberPlan

National numbering plan.

EPrivateNumberPlan

Private numbering plan.

EERMESNumberPlan

ERMES numbering plan.


Enum anonymous

n/a

Description

Max size of Manufacturer Id.

KPhoneManufacturerIdSize


Enum anonymous

n/a

Description

Max size of Phone Model Id.

KPhoneModelIdSize


Enum anonymous

n/a

Description

Max size ofSerial Number.

KPhoneSerialNumberSize


Enum anonymous

n/a

Description

Maximum size of IMSI identifier.

KIMSISize


Enum TFlightModeStatus

TFlightModeStatus

Description

The flight mode status.

EFlightModeOff

Flight mode is off.

EFlightModeOn

Flight mode is on.


Enum TPhoneIndicators

TPhoneIndicators

Description

The mobile phone indicators.

KIndChargerConnected

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

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

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 TBatteryStatus

TBatteryStatus

Description

The mobile phone battery status.

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 TIccLock

TIccLock

Description

Pin 1/Pin 2 security

ELockPin1

Lock PIN1 on the ICC.

ELockPin2

Lock PIN2 on the ICC.


Enum TIccLockStatus

TIccLockStatus

Description

Status of an ICC lock.

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 TIccLockSetting

TIccLockSetting

Description

Setting of the ICC lock.

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 TPhoneLine

TPhoneLine

Description

Line types

EVoiceLine

Voice line.

EDataLine

Data line.

EFaxLine

Fax line.


Enum TCallStatus

TCallStatus

Description

Describes the possible call or line states.

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 TCallSelect

TCallSelect

Description

Select a call defined by it current stats.

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 TCallId

TCallId

Description

Etel 3rd Party owned call identifiers

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

TCallRemoteIdentityStatus

Description

Remote party identity status.

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 TCallDirection

TCallDirection

Description

The direction of the call.

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 TPhoneNetworkSecurity

TPhoneNetworkSecurity

Description

Enumerated network security types.

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 anonymous

n/a

Description

Maximum size of the calling party name.

KCallingNameSize


Enum TCallerIdentityRestrict

TCallerIdentityRestrict

Description

Caller Id restriction settings.

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 TMobileCallControlCaps

TMobileCallControlCaps

Description

Mobile call control capabilities.

KCapsHold

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

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

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 TRegistrationStatus

TRegistrationStatus

Description

The registration status of the phone.

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 anonymous

n/a

Description

Maximum size of the network country code.

KNetworkCountryCodeSize


Enum anonymous

n/a

Description

Maximum size of the network identity..

KNetworkIdentitySize


Enum anonymous

n/a

Description

Maximum size of the network display tag..

KNetworkDisplayTagSize


Enum anonymous

n/a

Description

Maximum size of the short network name.

KNetworkShortNameSize


Enum anonymous

n/a

Description

Maximum size of the long network name.

KNetworkLongNameSize


Enum anonymous

n/a

Description

Maximum size of the short network name version 2.

KNetworkShortNameSizeV2


Enum anonymous

n/a

Description

Maximum size of the long network name version 2.

KNetworkLongNameSizeV2


Enum TNetworkMode

TNetworkMode

Description

Defines Current Network Modes.

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 TNetworkAccess

TNetworkAccess

Description

The access technology that the network is based on.

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 TNetworkStatus

TNetworkStatus

Description

Phone network status.

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 TNetworkBandInfo

TNetworkBandInfo

Description

Mobile phone network band information.

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 TSupplServiceStatus

TSupplServiceStatus

Description

Supplementary Service status.

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 TCallForwardingCondition

TCallForwardingCondition

Description

Call Forwarding conditions.

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 TCallBarringCondition

TCallBarringCondition

Description

Call Barring conditions.

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 TIdentityService

TIdentityService

Description

Phone ID services.

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

TIdentityServiceStatus

Description

Service status of the Phone ID services.

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 TServiceGroup

TServiceGroup

Description

Service group identifier.

EVoiceService

Voice service group

EFaxService

Fax service group

EDataService

Data service group


Enum TCancellationRequest

TCancellationRequest

Description

Cancel apending request

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 TNotificationEvent

TNotificationEvent

Description

Notification events

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

[Top]


Member type definitions


Typedef TTelNumber

typedef TBuf<KMaxTelNumberSize> CTelephony::TTelNumber;

Description

A typedef to hold the telephone number.


Typedef TPhoneIdV1Pckg

typedef TPckg<TPhoneIdV1> CTelephony::TPhoneIdV1Pckg;

Description

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


Typedef TSubscriberIdV1Pckg

typedef TPckg<TSubscriberIdV1> CTelephony::TSubscriberIdV1Pckg;

Description

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


Typedef TFlightModeV1Pckg

typedef TPckg<TFlightModeV1> CTelephony::TFlightModeV1Pckg;

Description

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


Typedef TIndicatorV1Pckg

typedef TPckg<TIndicatorV1> CTelephony::TIndicatorV1Pckg;

Description

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


Typedef TBatteryInfoV1Pckg

typedef TPckg<TBatteryInfoV1> CTelephony::TBatteryInfoV1Pckg;

Description

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


Typedef TSignalStrengthV1Pckg

typedef TPckg<TSignalStrengthV1> CTelephony::TSignalStrengthV1Pckg;

Description

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


Typedef TIccLockInfoV1Pckg

typedef TPckg<TIccLockInfoV1> CTelephony::TIccLockInfoV1Pckg;

Description

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


Typedef TCallStatusV1Pckg

typedef TPckg<TCallStatusV1> CTelephony::TCallStatusV1Pckg;

Description

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


Typedef TCallSelectionV1Pckg

typedef TPckg<TCallSelectionV1> CTelephony::TCallSelectionV1Pckg;

Description

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


Typedef TCallInfoV1Pckg

typedef TPckg<TCallInfoV1> CTelephony::TCallInfoV1Pckg;

Description

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


Typedef TRemotePartyInfoV1Pckg

typedef TPckg<TRemotePartyInfoV1> CTelephony::TRemotePartyInfoV1Pckg;

Description

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


Typedef TCallParamsV1Pckg

typedef TPckg<TCallParamsV1> CTelephony::TCallParamsV1Pckg;

Description

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


Typedef TCallCapsV1Pckg

typedef TPckg<TCallCapsV1> CTelephony::TCallCapsV1Pckg;

Description

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


Typedef TNetworkRegistrationV1Pckg

typedef TPckg<TNetworkRegistrationV1> CTelephony::TNetworkRegistrationV1Pckg;

Description

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


Typedef TNetworkInfoV1Pckg

typedef TPckg<TNetworkInfoV1> CTelephony::TNetworkInfoV1Pckg;

Description

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


Typedef TNetworkNameV1Pckg

typedef TPckg<TNetworkNameV1> CTelephony::TNetworkNameV1Pckg;

Description

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


Typedef TOperatorNameV1Pckg

typedef TPckg<TOperatorNameV1> CTelephony::TOperatorNameV1Pckg;

Description

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


Typedef TNetworkInfoV2Pckg

typedef TPckg<TNetworkInfoV2> CTelephony::TNetworkInfoV2Pckg;

Description

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


Typedef TNetworkNameV2Pckg

typedef TPckg<TNetworkNameV2> CTelephony::TNetworkNameV2Pckg;

Description

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 TCallForwardingSupplServicesV1Pckg

typedef TPckg<TCallForwardingSupplServicesV1> CTelephony::TCallForwardingSupplServicesV1Pckg;

Description

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


Typedef TCallBarringSupplServicesV1Pckg

typedef TPckg<TCallBarringSupplServicesV1> CTelephony::TCallBarringSupplServicesV1Pckg;

Description

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


Typedef TCallWaitingSupplServicesV1Pckg

typedef TPckg<TCallWaitingSupplServicesV1> CTelephony::TCallWaitingSupplServicesV1Pckg;

Description

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


Typedef TIdentityServiceV1Pckg

typedef TPckg<TIdentityServiceV1> CTelephony::TIdentityServiceV1Pckg;

Description

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