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.

Derivation

• CBase - Base class for all classes to be instantiated on the heap
• CTelephony - This class provides a simple interface to the phone's telephony system

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, KIMSISize, KIndCallInProgress, KIndChargerConnected, KIndNetworkAvailable, KMaxTelNumberSize, KNetworkCountryCodeSize, KNetworkDisplayTagSize, KNetworkIdentitySize, KNetworkLongNameSize, KNetworkShortNameSize, 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, TNetworkMode, TNetworkNameV1, TNetworkNameV1Pckg, 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

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

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.

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.

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

Capability:

ReadDeviceData

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

Description

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

Upon successful completion of the request the manufacturer name, model and serial number (IMEI or ESN) are returned back to the client via the aId 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.

Capability:

ReadDeviceData

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

Description

Retrieve 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.

Upon successful completion of the request the serial number of the SIM or R-UIM card is returned back to the client via the aId 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.

Capability:

None

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

Description

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

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.

Capability:

None

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

Description

Retrieves the battery charging indicator, the network availability indicator and call-in-progress indicator. 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:

• TPhoneIndicators

Capability:

None

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

Description

Retrieve the mobile phone battery's status and charge level.

Upon successful completion of the request the battery information is returned via the packaged aBatteryInfo 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.

Capability:

None

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

Description

Retrieve the phone's current signal strength via the aSignalStrength argument.

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.

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 wishes to retrieve the status and state of. Upon successful completion of the request the PIN1/2 information is returned via the aLockInfo 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.

Capability:

NetworkServices

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

Description

Transmit DTMF tones across all the current active voice calls.

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 #.

Capability:

None

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

Description

Retrieve 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.

Capability:

ReadUserData

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

Description

Retrieve 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.

Capability:

NetworkServices

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

Description

Initiate a new call.

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

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:

• AnswerIncomingCall()
• Hold()
• Resume()
• Swap()
• Hangup()
• GetCallStatus()
• GetCallDynamicCaps()

Capability:

None

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

Description

Retrieve 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 aCallCaps 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.

Capability:

None

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

Description

Retrieve 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 aCallStatus argument. Support 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:

• AnswerIncomingCall()
• DialNewCall()
• Hold()
• Resume()
• Swap()
• Hangup()
• GetCallDynamicCaps()

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 operation of Hold for this call to have successful completion of this request; see CTelephony::GetCallDynamicCaps().

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:

• AnswerIncomingCall()
• DialNewCall()
• Resume()
• Swap()
• Hangup()
• GetCallStatus()
• GetCallDynamicCaps()

Capability:

NetworkServices

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

Description

Resume held calls. 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 operation of Resume for this call to have successful completion of this request; see CTelephony::GetCallDynamicCaps().

Upon successful completion of Resume, line and call status might be affected 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:

• AnswerIncomingCall()
• DialNewCall()
• Hold()
• Swap()
• Hangup()
• GetCallStatus()
• GetCallDynamicCaps()

Capability:

NetworkServices

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

Description

Swap 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.

The calls' dynamic capabilities must allow the operation of Swap 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:

• AnswerIncomingCall()
• DialNewCall()
• Hold()
• Resume()
• Hangup()
• GetCallStatus()
• GetCallDynamicCaps()

Capability:

NetworkServices

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

Description

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

The client specifies the call ID via the aCallId argument.

Upon successful completion of Hangup, the line and call status might be affected. Support 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()
• DialNewCall()
• Hold()
• Resume()
• Swap()
• GetCallStatus()
• GetCallDynamicCaps()

Capability:

NetworkServices

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

Description

Answer incoming new voice calls. Fax and data calls cannot be answered.

Answering an incoming call is possible only when the voice line status is ringing (CTelephony::EStatusRinging). 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:

• DialNewCall()
• Hold()
• Resume()
• Swap()
• Hangup()
• GetCallStatus()
• GetCallDynamicCaps()

Capability:

None

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

Description

Retrieve the current network registration status. Upon successful completion of this request the registration status is returned via the aStatus 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.

Capability:	ReadUserData
Capability:	ReadDeviceData
Capability:	Location

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

Description

Retrieve over-the-air network information about t