Destructor

Deletes the underlying CTelephonyFunctions object.

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.

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.

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.

RConnection RSocket RMobilePhone

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.

RConnection RSocket RMobilePhone

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.

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.

RConnection RSocket RMobilePhone

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.

RConnection RSocket RMobilePhone

This method is no longer supported.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

RConnection RSocket RMobilePhone

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.

RConnection RSocket RMobilePhone

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.

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.

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.

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.

RConnection RSocket RMobilePhone

Get current CTelephony version

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

Unique parameter class identifier.

The mobile phone battery status.

Call Barring conditions.

The direction of the call.

Call Forwarding conditions.

Etel 3rd Party owned call identifiers

Remote party identity status.

Select a call defined by it current stats.

Describes the possible call or line states.

Caller Id restriction settings.

Cancel apending request

The flight mode status.

Pin 1/Pin 2 security

Setting of the ICC lock.

Status of an ICC lock.

Phone ID services.

Service status of the Phone ID services.

Mobile call control capabilities.

The access technology that the network is based on.

Mobile phone network band information.

Defines Current Network Modes.

Phone network status.

Notification events

The mobile phone indicators.

Line types

Enumerated network security types.

The registration status of the phone.

Service group identifier.

Supplementary Service status.

Number Plan Indicator.

Address types.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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.

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

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

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

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

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

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

A typedef to hold the telephone number.