CTelephony in Telephony ETel_3rd_Party

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

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. It provi...

Members

Defined in CTelephony:

AnswerIncomingCall(TRequestStatus &,TCallId &,const TPhoneLine)constAnswers an incoming new voice call. Fax and data calls cannot be answered.
CancelAsync(TCancellationRequest)constCancels an outstanding asynchronous request.
CancelEstablishDataCall()This method is no longer supported.
CancelReceiveDataCall()This method is no longer supported.
DialNewCall(TRequestStatus &,TDes8 &,const TTelNumber &,TCallId &,const TPhoneLine)constInitiates a new call.
E1900BandAThe network operates at 1900MHz on Band A.
E1900BandBThe network operates at 1900MHz on Band B.
E1900BandCThe network operates at 1900MHz on Band C.
E1900BandDThe network operates at 1900MHz on Band D.
E1900BandEThe network operates at 1900MHz on Band E.
E1900BandFThe network operates at 1900MHz on Band F.
E800BandAThe network operates at 800MHz on Band A.
E800BandBThe network operates at 800MHz on Band B.
E800BandCThe network operates at 800MHz on Band C.
EAbbreviatedNumberAbbreviated number.
EActiveCallCurrently active call.
EAlphanumericNumberAlphanumeric number.
EAnswerIncomingCallCancelCancel a pending AnswerIncomingCall request.
EBandUnknownThe current band and band class is unknown.
EBarAllIncomingAll incoming calls to this subscriber are barred (BAIC).
EBarAllOutgoingAll outgoing calls by this subscriber are barred (BAOC).
EBarIncomingRoamingAll incoming calls to this subscriber are barred when roaming outside the home P...
EBarOutgoingInternationalAll outgoing international calls by this subscriber are barred (BOIC).
EBarOutgoingInternationalExHCAll outgoing international calls except those directed to the home PLMN country ...
EBatteryConnectedButExternallyPoweredA battery is connected, but the phone is externally powered.
EBatteryInfoChangeRegister interest for receiving a notification for Battery information changes.
EBatteryInfoChangeCancelCancel a pending BatteryInfoChange request.
ECallForwardingBusyCalls are forwarded when this subscriber is busy.
ECallForwardingNoReplyCalls are forwarded when this subscriber does not reply within a timeout period.
ECallForwardingNotReachableCalls are forwarded when this subscriber is unreachable.
ECallForwardingUnconditionalAll calls to this subscriber are forwarded.
ECipheringGSMThe encryption level is GSM.(standard encryption algorithms for 2nd Generation M...
ECipheringOffThe encryption level is NONE.
ECipheringWCDMAThe encryption level is WDCMA.(standard encryption algorithms for 3rd Generation...
ECurrentNetworkInfoChangeRegister interest for receiving a notification for Network information changes.
ECurrentNetworkInfoChangeCancelCancel a pending CurrentNetworkInfoChange request.
EDataLineData line.
EDataLineStatusChangeRegister interest for receiving a notification for Data Line Status changes.
EDataLineStatusChangeCancelCancel a pending DataLineStatusChange request.
EDataNumberPlanData numbering plan.
EDataServiceData service group
EDialNewCallCancelCancel a pending DialNewCall request.
EDirectionUnknownThe direction of the call is unknown.
EDontSendMyIdThe user has explicitly requested their identity not to be sent for this call.
EERMESNumberPlanERMES numbering plan.
EFaxLineFax line.
EFaxLineStatusChangeRegister interest for receiving a notification for Fax Line Status changes.
EFaxLineStatusChangeCancelCancel a pending FaxLineStatusChange request.
EFaxServiceFax service group
EFlightModeChangeRegister interest for receiving a notification for flight mode changes.
EFlightModeChangeCancelCancel a pending FlightModeChange request.
EFlightModeOffFlight mode is off.
EFlightModeOnFlight mode is on.
EGetBatteryInfoCancelCancel a pending GetBatteryInfo request.
EGetCallBarringStatusCancelCancel a pending GetCallBarringStatus request.
EGetCallForwardingStatusCancelCancel a pending GetCallForwardingStatus request.
EGetCallWaitingStatusCancelCancel a pending GetCallWaitingStatus request.
EGetCurrentNetworkInfoCancelCancel a pending GetCurrentNetworkInfo request.
EGetCurrentNetworkNameCancelCancel a pending GetCurrentNetworkName request.
EGetFlightModeCancelCancel a pending GetFlightMode request.
EGetIdentityServiceStatusCancelCancel a pending GetIdentityServiceStatus request.
EGetIndicatorCancelCancel a pending GetIndicator request.
EGetLockInfoCancelCancel a pending GetLockInfo request.
EGetNetworkRegistrationStatusCancelCancel a pending GetNetworkRegistrationStatus request.
EGetOperatorNameCancelCancel a pending GetOperatorName request.
EGetPhoneIdCancelCancel a pending GetPhoneId request.
EGetSignalStrengthCancelCancel a pending GetSignalStrength request.
EGetSubscriberIdCancelCancel a pending GetSubscriberId request.
EHangupCancelCancel a pending Hangup request.
EHeldCallCurrently held (applicable only for voice) call.
EHoldCancelCancel a pending Hold request.
EISVCall1Call owned by this ISV application.
EISVCall2Call owned by this ISV application.
EISVMaxNumOfCallsMax number of calls supported by Etel 3rd Party.
EIdRestrictDefaultThe default setting should be used if the user has not explicitly requested thei...
EIdServiceActiveDefaultAllowedThe interrogated identity service is provisioned and active. By default, the num...
EIdServiceActiveDefaultRestrictedThe interrogated identity service is provisioned and active. By default, the num...
EIdServiceActivePermanentThe interrogated identity service is provisioned and permanently active.
EIdServiceCallerPresentationThe caller's ID is presented to the called party.
EIdServiceCallerRestrictionThe caller's ID is restricted to the called party.
EIdServiceNotProvisionedThe interrogated identity service is not provisioned.
EIdServiceUnknownThe status of the interrogated Identity service is unknown.
EIdServiceUnspecifiedThe identity service is unspecified.
EInProgressCallCall during the setup/disconnecting process - (dialling/connecting/answering/han...
EIndicatorChangeRegister interest for receiving a notification for phone indicator changes.
EIndicatorChangeCancelCancel a pending IndicatorChange request.
EInternationalNumberInternational number.
EIsdnNumberPlanISDN/telephony numbering plan.
ELockPin1Lock PIN1 on the ICC.
ELockPin2Lock PIN2 on the ICC.
ELockSetDisabledLock is disabled. It is not available for use, so its status is always CTelephon...
ELockSetEnabledLock is enabled, and is available for use. Its status may be CTelephony::EStatus...
ELockSetUnknownThe setting of the lock is unknown.
EMobileOriginatedThe call was originated by this phone, i.e. it is an outgoing call.
EMobileTerminatedThe call was terminated by this phone, i.e. it is an incoming call.
ENationalNumberNational number.
ENationalNumberPlanNational numbering plan.
ENetworkAccessGsmThe access technology is GSM.
ENetworkAccessGsmCompactThe access technology is GSM COMPACT. However GSM COMPACT systems which use GSM ...
ENetworkAccessUnknownThis is used when there is no network activity and therefore no RAT active.
ENetworkAccessUtranThe access technology is UTRAN (UMTS Network).
ENetworkModeAmpsAMPS network.
ENetworkModeCdma2000CDMA (cdma2000) network.
ENetworkModeCdma95CDMA (IS-95) network.
ENetworkModeGsmGSM/GPRS or DCS1800 network.
ENetworkModeTdcdmaTD-CDMA (UTRA Time Division Duplex (TDD)) network.
ENetworkModeUnknownNetwork mode is unknown.
ENetworkModeUnregisteredMobile device is not registered.
ENetworkModeWcdmaWCDMA (UTRA Frequency Division Duplex (FDD)) network.
ENetworkRegistrationStatusChangeRegister interest for receiving a notification for Network registration status c...
ENetworkRegistrationStatusChangeCancelCancel a pending NetworkRegistrationStatusChange request.
ENetworkSpecificNumberAdministration/service number specific to the serving network, e.g. used to acce...
ENetworkStatusAvailableA network that the mobile device is allowed to register to.
ENetworkStatusCurrentCurrently registered network.
ENetworkStatusForbiddenA network that the ME is not allowed to register to.
ENetworkStatusUnknownStatus is unknown.
ENoBatteryConnectedNo battery is connected.
ENotActiveThe supplementary service is currently deactivated or quiescent.
ENotAvailableIn GSM/WCDMA mode, the supplementary service is not available in serving network...
ENotProvisionedIn GSM/WCDMA mode, the supplementary service is not provisioned. In CDMA mode, t...
ENotRegisteredEmergencyOnlyNot registered. The ME can detect other networks on which it is possible to make...
ENotRegisteredNoServiceNot registered. The ME can not detect any other networks and is not currently se...
ENotRegisteredSearchingNot registered, but the ME is currently searching a new operator to register to.
EOwnedCall1RemotePartyInfoChangeRegister interest for receiving a notification for Call 1 Remote Party Info chan...
EOwnedCall1RemotePartyInfoChangeCancelCancel a pending OwnedCall1RemotePartyInfoChange request.
EOwnedCall1StatusChangeRegister interest for receiving a notification for owned Call 1 Status changes.
EOwnedCall1StatusChangeCancelCancel a pending Call1StatusChange request.
EOwnedCall2RemotePartyInfoChangeRegister interest for receiving a notification for Call 2 Remote Party Info chan...
EOwnedCall2RemotePartyInfoChangeCancelCancel a pending OwnedCall2RemotePartyInfoChange request.
EOwnedCall2StatusChangeRegister interest for receiving a notification for owned Call 2 Status changes.
EOwnedCall2StatusChangeCancelCancel a pending Call2StatusChange request.
EPin1LockInfoChangeRegister interest for receiving a notification for Icc Pin1 Lock Information cha...
EPin1LockInfoChangeCancelCancel a pending Pin 1 LockInfoChange request.
EPin2LockInfoChangeRegister interest for receiving a notification for Icc Pin2 Lock Information cha...
EPin2LockInfoChangeCancelCancel a pending Pin 2 LockInfoChange request.
EPowerFaultPower fault.
EPowerStatusUnknownThe phone software can not determine the phone's current power status.
EPoweredByBatteryThe phone is powered by the battery.
EPrivateNumberPlanPrivate numbering plan.
ERegisteredBusyRegistered, network busy.
ERegisteredOnHomeNetworkRegistered on home network.
ERegisteredRoamingRegistered, roaming.
ERegistrationDeniedRegistration denied.
ERegistrationUnknownRegistration status is unknown.
ERemoteIdentityAvailableThe remote party's identity is available.
ERemoteIdentitySuppressedThe remote party has suppressed the transmission of its identity.
ERemoteIdentityUnknownThe remote party's identity can not be determined.
EResumeCancelCancel a pending Resume request.
ESendDTMFTonesCancelCancel a pending SendDTMFTones request.
ESendMyIdThe user has explicitly requested their identity to be sent for this call.
EServiceCentreSpecificPlan1Service centre specific plan used to indicate a numbering plan specific to exter...
EServiceCentreSpecificPlan2Service centre specific plan used to indicate a numbering plan specific to exter...
ESignalStrengthChangeRegister interest for receiving a notification for Signal Strength changes.
ESignalStrengthChangeCancelCancel a pending SignalStrengthChange request.
EStatusActiveThe supplementary service is currently active and operative.
EStatusAnsweringCall answering status.
EStatusBlockedLock is blocked.
EStatusConnectedCall connected status.
EStatusConnectingCall connecting status.
EStatusDiallingCall dialling status .
EStatusDisconnectingCall disconnecting status.
EStatusHoldCall on hold.
EStatusIdleIdle line status (no active calls).
EStatusLockUnknownThe status of the lock is unknown.
EStatusLockedLock is closed.
EStatusReconnectPendingCall is undergoing temporary channel loss and it may or may not be reconnected.
EStatusRingingCall ringing status.
EStatusTransferAlertingCall in transfer is alerting the remote party.
EStatusTransferringCall is transferring.
EStatusUnknownIndicates that the status is unknown.
EStatusUnlockedLock is open.
ESubscriberNumberSubscriber number.
ESwapCancelCancel a pending Swap request.
ETelexNumberPlanTelex numbering plan.
EUnknownThe phone can not determine supplementary service status.
EUnknownNumber User or the network has no knowledge of the type of number.
EUnknownNumberingPlan User or the network has no knowledge of the numbering plan.
EVoiceLineVoice line.
EVoiceLineStatusChangeRegister interest for receiving a notification for Voice Line Status changes.
EVoiceLineStatusChangeCancelCancel a pending VoiceLineStatusChange request.
EVoiceServiceVoice service group
EstablishDataCall(TInt &,const TDesC &)This method is no longer supported.
EstablishDataCall(TRequestStatus &,TInt &,const TDesC &)This method is no longer supported.
FindDeviceStatus(TInt &)This method is no longer supported.
GetBatteryInfo(TRequestStatus &,TDes8 &)constRetrieves the status and charge level of the phone battery.
GetCallBarringStatus(TRequestStatus &,const TCallBarringCondition,TDes8 &,const TServiceGroup)constInterrogate the current status of the call barring services.
GetCallDynamicCaps(const TCallId &,TDes8 &)constRetrieves the dynamic call capabilities for calls you dialled or answered with C...
GetCallForwardingStatus(TRequestStatus &,const TCallForwardingCondition,TDes8 &,const TServiceGroup)constInterrogates the current status of the call forwarding services.
GetCallInfo(TDes8 &,TDes8 &,TDes8 &)constRetrieves information about the call selected by the aCallSelect argument.
GetCallStatus(const TCallId &,TDes8 &)constRetrieves the status of the selected call specified by the aCallId argument.
GetCallWaitingStatus(TRequestStatus &,TDes8 &,const TServiceGroup)constInterrogate the current status of the call waiting services.
GetCurrentNetworkInfo(TRequestStatus &,TDes8 &)constRetrieves over-the-air network information about the currently registered mobile...
GetCurrentNetworkName(TRequestStatus &,TDes8 &)constRetrieves ICC-stored information about the (preferred) name of the currently reg...
GetFlightMode(TRequestStatus &,TDes8 &)constRetrieves the current flight mode status. The flight mode is returned via the aM...
GetIdentityServiceStatus(TRequestStatus &,const TIdentityService &,TDes8 &)constInterrogate the current status of the identity services.
GetIndicator(TRequestStatus &,TDes8 &)constRetrieves the battery charging indicator, the network availability indicator and...
GetLineStatus(const TPhoneLine &,TDes8 &)constRetrieves the status of the line selected by the aLine argument. The current sta...
GetLockInfo(TRequestStatus &,const TIccLock &,TDes8 &)constSome phones allow users to lock them to prevent unauthorised use. Typically, a c...
GetNetworkRegistrationStatus(TRequestStatus &,TDes8 &)constRetrieves the current network registration status.
GetOperatorName(TRequestStatus &,TDes8 &)constRetrieve ICC stored information about the currently registered mobile network. U...
GetPhoneId(TRequestStatus &,TDes8 &)constRetrieves the model information and unique identification of the mobile device.
GetSignalStrength(TRequestStatus &,TDes8 &)constRetrieves the phone's current signal strength via the aDes argument.
GetSubscriberId(TRequestStatus &,TDes8 &)constRetrieves information about the mobile device's current subscriber. This will no...
Hangup(TRequestStatus &,const TCallId &)constHangs up a call. This is only for calls you dialled or answered with CTelephony.
Hold(TRequestStatus &,const TCallId &)constPlaces a call on hold. This is only for calls you dialled or answered with CTele...
KCallingNameSize
KCapsHoldIndicates that this call can be put on hold. This implies that the call is curre...
KCapsResumeIndicates that this call can be resumed. This implies that the call is currently...
KCapsSwapIndicates that this call's state can be swapped to the opposite state. This impl...
KEtelISVV1Unique reference identifier for Etel 3rd Party v1.0 parameter classes.
KEtelISVV2Unique reference identifier for Etel 3rd Party v2.0 parameter classes.
KIMSISize
KIndCallInProgressIf bit-flag is set to '1' indicates that a call is in progress. If set to '0' in...
KIndChargerConnectedIf bit-flag is set to '1' indicates that the battery charger is connected to the...
KIndNetworkAvailableIf bit-flag is set to '1' indicates that network service is available. If bit-fl...
KMaxTelNumberSize
KNetworkCountryCodeSize
KNetworkDisplayTagSize
KNetworkIdentitySize
KNetworkLongNameSize
KNetworkLongNameSizeV2
KNetworkShortNameSize
KNetworkShortNameSizeV2
KPhoneManufacturerIdSize
KPhoneModelIdSize
KPhoneSerialNumberSize
NewL()Constructs a CTelephony object.
NewLC()Constructs a CTelephony object.
NotifyChange(TRequestStatus &,const TNotificationEvent &,TDes8 &)constRegisters interest in receiving change notifications for events.
ReceiveDataCall(TInt &)This method is no longer supported.
ReceiveDataCall(TRequestStatus &,TInt &)This method is no longer supported.
Resume(TRequestStatus &,const TCallId &)constResumes a held call. This is only for calls you dialled or answered with CTeleph...
SendDTMFTones(TRequestStatus &,const TDesC &)constTransmits DTMF tones across all the current active voice calls.
Swap(TRequestStatus &,const TCallId &,const TCallId &)constSwaps calls. This is only for calls you dialled or answered with CTelephony.
TBatteryInfoV1Defines contents of the battery status of the phone.
TBatteryInfoV1PckgA typedef'd packaged CTelephony::TBatteryInfoV1 for passing through a generic AP...
TBatteryStatusThe mobile phone battery status.
TCallBarringConditionCall Barring conditions.
TCallBarringSupplServicesV1Defines information about the call barring service.
TCallBarringSupplServicesV1PckgA typedef'd packaged CTelephony::TCallBarringSupplServicesV1 for passing through...
TCallCapsV1
TCallCapsV1PckgA typedef'd packaged CTelephony::TCallParamsV1 for passing through a generic API...
TCallDirectionThe direction of the call.
TCallForwardingConditionCall Forwarding conditions.
TCallForwardingSupplServicesV1Defines information about the call forwarding service.
TCallForwardingSupplServicesV1PckgA typedef'd packaged CTelephony::TCallForwardingSupplServicesV1 for passing thro...
TCallIdEtel 3rd Party owned call identifiers
TCallInfoV1Defines general information about a call.
TCallInfoV1PckgA typedef'd packaged CTelephony::TCallInfoV1 for passing through a generic API m...
TCallParamsV1
TCallParamsV1PckgA typedef'd packaged CTelephony::TCallParamsV1 for passing through a generic API...
TCallRemoteIdentityStatusRemote party identity status.
TCallSelectSelect a call defined by it current stats.
TCallSelectionV1Defines parameters to select a call, determined by its call state for a specific...
TCallSelectionV1PckgA typedef'd packaged CTelephony::TCallSelectionV1 for passing through a generic ...
TCallStatusDescribes the possible call or line states.
TCallStatusV1Defines the current call or line status.
TCallStatusV1PckgA typedef'd packaged CTelephony::TCallStatusV1 for passing through a generic API...
TCallWaitingSupplServicesV1Defines information about the call waiting service.
TCallWaitingSupplServicesV1PckgA typedef'd packaged CTelephony::TCallWaitingSupplServicesV1 for passing through...
TCallerIdentityRestrictCaller Id restriction settings.
TCancellationRequestCancel apending request
TEtelISVTypeSpecifies which version of an API parameter a client has used. For most ETel ISV...
TFlightModeStatusThe flight mode status.
TFlightModeV1Defines the flight mode status.
TFlightModeV1PckgA typedef'd packaged CTelephony::TFlightModeV1 for passing through a generic API...
TIccLockPin 1/Pin 2 security
TIccLockInfoV1Defines the Icc Lock parameters.
TIccLockInfoV1PckgA typedef'd packaged CTelephony::TIccLockInfoV1 for passing through a generic AP...
TIccLockSettingSetting of the ICC lock.
TIccLockStatusStatus of an ICC lock.
TIdentityServicePhone ID services.
TIdentityServiceStatusService status of the Phone ID services.
TIdentityServiceV1Defines the call identity service status.
TIdentityServiceV1PckgA typedef'd packaged CTelephony::TIdentityServiceV1 for passing through a generi...
TIndicatorV1Contains indicator parameters:
TIndicatorV1PckgA typedef'd packaged CTelephony::TIndicatorV1 for passing through a generic API ...
TMobileCallControlCapsMobile call control capabilities.
TNetworkAccessThe access technology that the network is based on.
TNetworkBandInfoMobile phone network band information.
TNetworkInfoV1Defines information related to a mobile phone network.
TNetworkInfoV1PckgA typedef'd packaged CTelephony::TNetworkInfoV1 for passing through a generic AP...
TNetworkInfoV2Defines information related to a mobile phone network. CTelephony::TNetworkInfoV...
TNetworkInfoV2PckgA typedef'd packaged CTelephony::TNetworkInfoV2 for passing through a generic AP...
TNetworkModeDefines Current Network Modes.
TNetworkNameV1Defines the name network name.
TNetworkNameV1PckgA typedef'd packaged CTelephony::TNetworkNameV1 for passing through a generic AP...
TNetworkNameV2Defines the name network name. CTelephony::TNetworkNameV2 differs from Version 1...
TNetworkNameV2PckgA typedef'd packaged CTelephony::TNetworkNameV2 for passing through a generic AP...
TNetworkRegistrationV1Defines the current network registration status
TNetworkRegistrationV1PckgA typedef'd packaged CTelephony::TNetworkRegistrationV1 for passing through a ge...
TNetworkStatusPhone network status.
TNotificationEventNotification events
TOperatorNameV1Defines the current operator.
TOperatorNameV1PckgA typedef'd packaged CTelephony::TOperatorNameV1 for passing through a generic A...
TPhoneIdV1Defines the mobile phone identity.
TPhoneIdV1PckgA typedef'd packaged CTelephony::TPhoneIdV1 for passing through a generic API me...
TPhoneIndicatorsThe mobile phone indicators.
TPhoneLineLine types
TPhoneNetworkSecurityEnumerated network security types.
TRegistrationStatusThe registration status of the phone.
TRemotePartyInfoV1
TRemotePartyInfoV1PckgA typedef'd packaged CTelephony::TRemotePartyInfoV1 for passing through a generi...
TServiceGroupService group identifier.
TSignalStrengthV1Defines the phone's current signal strength.
TSignalStrengthV1PckgA typedef'd packaged CTelephony::TSignalStrengthV1 for passing through a generic...
TSubscriberIdV1Defines the Subscriber (IMSI) Id
TSubscriberIdV1PckgA typedef'd packaged CTelephony::TSubscriberIdV1 for passing through a generic A...
TSupplServiceStatusSupplementary Service status.
TTelAddressDefines API abstraction of a mobile telephone number.
TTelNumberA typedef to hold the telephone number.
TTelNumberNPINumber Plan Indicator.
TTelNumberTONAddress types.
TerminateDataCall()This method is no longer supported.
Version()constGet current CTelephony version
anonymousUnique parameter class identifier.
anonymousThe maximum number of digits allowed in a multimode telephone number.
anonymousMax size of Manufacturer Id.
anonymousMax size of Phone Model Id.
anonymousMax size ofSerial Number.
anonymousMaximum size of IMSI identifier.
anonymousMaximum size of the calling party name.
anonymousMaximum size of the network country code.
anonymousMaximum size of the network identity..
anonymousMaximum size of the network display tag..
anonymousMaximum size of the short network name.
anonymousMaximum size of the long network name.
anonymousMaximum size of the short network name version 2.
anonymousMaximum size of the long network name version 2.

Inherited from CBase:

Delete(CBase *)Deletes the specified object.
Extension_(TUint,TAny *&,TAny *)Extension function
operator new(TUint)Allocates the object from the heap and then initialises its contents to binary z...
operator new(TUint,TAny *)Initialises the object to binary zeroes.
operator new(TUint,TLeave)Allocates the object from the heap and then initialises its contents to binary z...
operator new(TUint,TLeave,TUint)Allocates the object from the heap and then initialises its contents to binary z...
operator new(TUint,TUint)Allocates the object from the heap and then initialises its contents to binary z...

IMPORT_C static 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.

IMPORT_C static 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:

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(TCancellationRequest)const` `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

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(TCancellationRequest)const` `CTelephony::EGetSubscriberIdCancel` to cancel.
`TDes8 &aId`	Contains a `CTelephony::TSubscriberIdV1Pckg`, a packaged version of the `CTelephony::TSubscriberIdV1` class which is filled on completion.

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(TCancellationRequest)const` `CTelephony::EGetFlightModeCancel` to cancel.
`TDes8 &aMode`	Contains a `CTelephony::TFlightModeV1Pckg`, a packaged version of the `CTelephony::TFlightModeV1` class which is filled on completion.

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(TCancellationRequest)const` `CTelephony::EGetBatteryInfoCancel` to cancel.
`TDes8 &aIndicator`	Contains a `CTelephony::TIndicatorV1Pckg`, a packaged version of the `CTelephony::TIndicatorV1` class which is filled on completion.

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(TCancellationRequest)const` `CTelephony::EGetBatteryInfoCancel` to cancel.
`TDes8 &aBatteryInfo`	Contains a `CTelephony::TBatteryInfoV1Pckg`, a packaged version of the `CTelephony::TBatteryInfoV1` class which is filled on completion.

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(TCancellationRequest)const` `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 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(TCancellationRequest)const` `CTelephony::EGetLockInfoCancel` to cancel.
`const CTelephony::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

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 TDesC16 &aTones`	String containing tones to transmit. It can contain one or more occurance of the numbers 0 to 9, * and #.

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 CTelephony::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

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(TRequestStatus &,const TNotificationEvent &,TDes8 &)const. 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

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(TCancellationRequest)const` `CTelephony::EDialNewCallCancel` to cancel.
`TDes8 &aCallParams`	The call parameters used by the TSY. Pass a `CTelephony::TCallParamsV1Pckg`, a packaged `CTelephony::TCallParamsV1`.
`const TBuf &aTelNumber`	Telephone number to dial.
`CTelephony::TCallId &aCallId`	Upon completion, contains the call identifier.
`const CTelephony::TPhoneLine aLine`	Line on which call can be made. Currently, only voice calls are supported.

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 CTelephony::TCallId &aCallId`	Call ID, as returned by `CTelephony::DialNewCall(TRequestStatus &,TDes8 &,const TTelNumber &,TCallId &,const TPhoneLine)const` or `CTelephony::AnswerIncomingCall(TRequestStatus &,TCallId &,const TPhoneLine)const`.
`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:

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 CTelephony::TCallId &aCallId`	Call ID, as returned by `CTelephony::DialNewCall(TRequestStatus &,TDes8 &,const TTelNumber &,TCallId &,const TPhoneLine)const` or `CTelephony::AnswerIncomingCall(TRequestStatus &,TCallId &,const TPhoneLine)const`.
`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.

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(const TCallId &,TDes8 &)const.

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(TCancellationRequest)const` `CTelephony::EHoldCancel` to cancel.
`const CTelephony::TCallId &aCallId`	Call ID, as returned by `CTelephony::DialNewCall(TRequestStatus &,TDes8 &,const TTelNumber &,TCallId &,const TPhoneLine)const` or `CTelephony::AnswerIncomingCall(TRequestStatus &,TCallId &,const TPhoneLine)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(const TCallId &,TDes8 &)const.

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(TCancellationRequest)const` `CTelephony::EResumeCancel` to cancel.
`const CTelephony::TCallId &aCallId`	Call ID, as returned by `CTelephony::DialNewCall(TRequestStatus &,TDes8 &,const TTelNumber &,TCallId &,const TPhoneLine)const` or `CTelephony::AnswerIncomingCall(TRequestStatus &,TCallId &,const TPhoneLine)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(const TCallId &,TDes8 &)const.

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(TCancellationRequest)const` `CTelephony::ESwapCancel` to cancel.
`const CTelephony::TCallId &aCallId1`	ID of a call, as returned by `CTelephony::DialNewCall(TRequestStatus &,TDes8 &,const TTelNumber &,TCallId &,const TPhoneLine)const` or `CTelephony::AnswerIncomingCall(TRequestStatus &,TCallId &,const TPhoneLine)const`.
`const CTelephony::TCallId &aCallId2`	ID of another call, as returned by `CTelephony::DialNewCall(TRequestStatus &,TDes8 &,const TTelNumber &,TCallId &,const TPhoneLine)const` or `CTelephony::AnswerIncomingCall(TRequestStatus &,TCallId &,const TPhoneLine)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(TCancellationRequest)const` `CTelephony::EHangupCancel` to cancel.
`const CTelephony::TCallId &aCallId`	Call ID, as returned by `CTelephony::DialNewCall(TRequestStatus &,TDes8 &,const TTelNumber &,TCallId &,const TPhoneLine)const` or `CTelephony::AnswerIncomingCall(TRequestStatus &,TCallId &,const TPhoneLine)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(TRequestStatus &,TName &) has completed.

This is an asynchronous method. Upon successful completion of CTelephony::AnswerIncomingCall(TRequestStatus &,TCallId &,const TPhoneLine)const 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(TCancellationRequest)const` `CTelephony::EAnswerIncomingCallCancel` to cancel
`CTelephony::TCallId &aCallId`	On completion, contains the call ID.
`const CTelephony::TPhoneLine aLine`	Line from which the answer request will attempted. Currently, only the voice line is supported.

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(TCancellationRequest)const` `CTelephony::EGetNetworkRegistrationStatusCancel` to cancel.
`TDes8 &aStatus`	Contains a `CTelephony::TNetworkRegistrationV1Pckg`, a packaged version of the `CTelephony::TNetworkRegistrationV1` class which is filled on completion.

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(TCancellationRequest)const` `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.

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(TCancellationRequest)const.

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.

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(TCancellationRequest)const.

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.

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(TCancellationRequest)const` `CTelephony::EGetCallForwardingStatusCancel` to cancel.
`const CTelephony::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 CTelephony::TServiceGroup aServiceGroup`	Service group to be interrogated.

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(TCancellationRequest)const` `CTelephony::EGetCallBarringStatusCancel` to cancel.
`const CTelephony::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 CTelephony::TServiceGroup aServiceGroup`	Service group to be interrogated.

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 CTelephony::TServiceGroup aServiceGroup`	Service group to be interrogated.

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(TCancellationRequest)const` `CTelephony::EGetIdentityServiceStatusCancel` to cancel.
`const CTelephony::TIdentityService &aService`
`TDes8 &aStatus`	Contains a `CTelephony::TIdentityServiceV1Pckg`, a packaged version of the `CTelephony::TIdentityServiceV1` class which is filled on completion.

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


                                 						CTelephony::TCancellationRequest aCancel

Canncellation code of request to be cancelled.

Return value

TInt

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(TCancellationRequest)const to cancel the notification request.

Parameters

`TRequestStatus &aReqStatus`	Returns the result code after the asynchronous call completes.
`const CTelephony::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.

Interface status:

deprecated

IMPORT_C TInt FindDeviceStatus(TInt &aCallStatus);

Description

This method is no longer supported.

Parameters


                                 						TInt &aCallStatus

Return value

TInt

KErrNotSupported

Interface status:

deprecated

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 TDesC16 &aDialNumber`

Return value

TInt

KErrNotSupported

Interface status:

deprecated

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 TDesC16 &aDialNumber`

Interface status:

deprecated

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

Interface status:

deprecated

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

Interface status:

deprecated

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`

Interface status:

deprecated

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.

Interface status:

deprecated

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.

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()constDefault constructor.
iVersionId

Member functions

`VersionId()const`

IMPORT_C TInt VersionId() const;

Description

Default constructor.

Return value

TInt

Member data

`iVersionId`

protected: TInt iVersionId;

Description

class TTelAddress;

Description

Defines API abstraction of a mobile telephone number.

Members

Defined in CTelephony::TTelAddress:

TTelAddress()Default constructor.
iNumberPlanNumber plan.
iTelNumberTelephone number.
iTypeOfNumberType of number.

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 : public CTelephony::TEtelISVType;

Description

Defines the mobile phone identity.

Derivation

CTelephony::TEtelISVType - Specifies which version of an API parameter a client has used. For most ETel ISV...

CTelephony::TPhoneIdV1 - Defines the mobile phone identity.

Members

Defined in CTelephony::TPhoneIdV1:

TPhoneIdV1()Default constructor.
iManufacturerPhone manufacturer identification, in character string format.
iModelPhone model identification, in character string format.
iSerialNumberPhone serial number (IMEI or ESN), in character string format.

Inherited from CTelephony::TEtelISVType:

VersionId()constDefault constructor.
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 : public CTelephony::TEtelISVType;

Description

Defines the Subscriber (IMSI) Id

Derivation

CTelephony::TEtelISVType - Specifies which version of an API parameter a client has used. For most ETel ISV...

CTelephony::TSubscriberIdV1 - Defines the Subscriber (IMSI) Id

Members

Defined in CTelephony::TSubscriberIdV1:

TSubscriberIdV1()
iSubscriberIdIMSI identifier.

Inherited from CTelephony::TEtelISVType:

VersionId()constDefault constructor.
iVersionId

Construction and destruction

`TSubscriberIdV1()`

IMPORT_C TSubscriberIdV1();

Description

Member data

`iSubscriberId`

TBuf< KIMSISize > iSubscriberId;

Description

IMSI identifier.

class TFlightModeV1 : public CTelephony::TEtelISVType;

Description

Defines the flight mode status.

Derivation

CTelephony::TEtelISVType - Specifies which version of an API parameter a client has used. For most ETel ISV...

CTelephony::TFlightModeV1 - Defines the flight mode status.

Members

Defined in CTelephony::TFlightModeV1:

TFlightModeV1()Default constructor.
iFlightModeStatusThe current status of the mobile radio interface and bluetooth.

Inherited from CTelephony::TEtelISVType:

VersionId()constDefault constructor.
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 : public CTelephony::TEtelISVType;

Description

Contains indicator parameters:

Derivation

CTelephony::TEtelISVType - Specifies which version of an API parameter a client has used. For most ETel ISV...

CTelephony::TIndicatorV1 - Contains indicator parameters:

Members

Defined in CTelephony::TIndicatorV1:

TIndicatorV1()Default constructor.
iCapabilitiesThe supported (available) indicator capability that the telephony service module...
iIndicatorThe value of the indicators. It is the sum of CTelephony::TPhoneIndicators const...

Inherited from CTelephony::TEtelISVType:

VersionId()constDefault constructor.
iVersionId

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 : public CTelephony::TEtelISVType;

Description

Defines contents of the battery status of the phone.

Derivation

CTelephony::TEtelISVType - Specifies which version of an API parameter a client has used. For most ETel ISV...

CTelephony::TBatteryInfoV1 - Defines contents of the battery status of the phone.

Members

Defined in CTelephony::TBatteryInfoV1:

TBatteryInfoV1()Default constructor.
iChargeLevelThe percentage battery charge level.
iStatusThe power and battery status.

Inherited from CTelephony::TEtelISVType:

VersionId()constDefault constructor.
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 : public CTelephony::TEtelISVType;

Description

Defines the phone's current signal strength.

Derivation

CTelephony::TEtelISVType - Specifies which version of an API parameter a client has used. For most ETel ISV...

CTelephony::TSignalStrengthV1 - Defines the phone's current signal strength.

Members

Defined in CTelephony::TSignalStrengthV1:

TSignalStrengthV1()Default constructor.
iBarThe absolute number of signal "bars" that the phone should display.
iSignalStrengthThe value of signal strength.

Inherited from CTelephony::TEtelISVType:

VersionId()constDefault constructor.
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 : public CTelephony::TEtelISVType;

Description

Defines the Icc Lock parameters.

Derivation

CTelephony::TEtelISVType - Specifies which version of an API parameter a client has used. For most ETel ISV...

CTelephony::TIccLockInfoV1 - Defines the Icc Lock parameters.

Members

Defined in CTelephony::TIccLockInfoV1:

TIccLockInfoV1()Default constructor.
iSettingThe current availability of the lock. When not available (i.e. the lock is not i...
iStatusThe current status of the lock.

Inherited from CTelephony::TEtelISVType:

VersionId()constDefault constructor.
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 : public CTelephony::TEtelISVType;

Description

Defines the current call or line status.

Derivation

CTelephony::TEtelISVType - Specifies which version of an API parameter a client has used. For most ETel ISV...

CTelephony::TCallStatusV1 - Defines the current call or line status.

Members

Defined in CTelephony::TCallStatusV1:

TCallStatusV1()Default constructor.
iStatusThe current call or line status.

Inherited from CTelephony::TEtelISVType:

VersionId()constDefault constructor.
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 : public CTelephony::TEtelISVType;

Description

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

Derivation

CTelephony::TEtelISVType - Specifies which version of an API parameter a client has used. For most ETel ISV...

CTelephony::TCallSelectionV1 - Defines parameters to select a call, determined by its call state for a specific...

Members

Defined in CTelephony::TCallSelectionV1:

TCallSelectionV1()Default constructor.
iLineThe current phone line selection.
iSelectThe current call selection.

Inherited from CTelephony::TEtelISVType:

VersionId()constDefault constructor.
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 : public CTelephony::TEtelISVType;

Description

Defines general information about a call.

Derivation

CTelephony::TEtelISVType - Specifies which version of an API parameter a client has used. For most ETel ISV...

CTelephony::TCallInfoV1 - Defines general information about a call.

Members

Defined in CTelephony::TCallInfoV1:

TCallInfoV1()Default constructor.
iCallIdThe call id of an ISV application owned call. For calls not owned by this ISV ap...
iDialledPartyThe original number (including DTMF) dialled for an outgoing call.
iDurationThe current duration of the call.
iExitCodeThe reason for termination of a finished call. Will equal KErrNone if the call e...
iSecurityThis attribute indicates whether Ciphering Status of a Call is enabled or disabl...
iStartTimeThe time & date the call started.
iStatusThe current status of the call.

Inherited from CTelephony::TEtelISVType:

VersionId()constDefault constructor.
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 : public CTelephony::TEtelISVType;

Description

Derivation

CTelephony::TEtelISVType - Specifies which version of an API parameter a client has used. For most ETel ISV...

CTelephony::TRemotePartyInfoV1 - (No abstract)

Members

Defined in CTelephony::TRemotePartyInfoV1:

TRemotePartyInfoV1()Defines information about the remote party of a call.
iCallingNameCalling party name available through the CNAP supplementary service (if provisio...
iDirectionThe direction of the call and hence the role of the remote party. i.e. if the ca...
iRemoteIdStatusIndicates whether the remote party information in the rest of this structure is ...
iRemoteNumberThe phone number of the remote party if available.

Inherited from CTelephony::TEtelISVType:

VersionId()constDefault constructor.
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 : public CTelephony::TEtelISVType;

Description

Derivation

CTelephony::TEtelISVType - Specifies which version of an API parameter a client has used. For most ETel ISV...

CTelephony::TCallParamsV1 - (No abstract)

Members

Defined in CTelephony::TCallParamsV1:

TCallParamsV1()Defines the parameters used for set-up of a call.
iIdRestrictCall Id restriction setting to be used for this call.

Inherited from CTelephony::TEtelISVType:

VersionId()constDefault constructor.
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 : public CTelephony::TEtelISVType;

Description

Derivation

CTelephony::TEtelISVType - Specifies which version of an API parameter a client has used. For most ETel ISV...

CTelephony::TCallCapsV1 - (No abstract)

Members

Defined in CTelephony::TCallCapsV1:

TCallCapsV1()Defines the dynamic capabilities of a call.
iControlCapsCall Id restriction setting to be used for this call. It is the sum of CTelephon...

Inherited from CTelephony::TEtelISVType:

VersionId()constDefault constructor.
iVersionId

Construction and destruction

`TCallCapsV1()`

IMPORT_C TCallCapsV1();

Description

Defines the dynamic capabilities of a call.

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 : public CTelephony::TEtelISVType;

Description

Defines the current network registration status

Derivation

CTelephony::TEtelISVType - Specifies which version of an API parameter a client has used. For most ETel ISV...

CTelephony::TNetworkRegistrationV1 - Defines the current network registration status

Members

Defined in CTelephony::TNetworkRegistrationV1:

TNetworkRegistrationV1()Default constructor.
iRegStatusThe current network registration status.

Inherited from CTelephony::TEtelISVType:

VersionId()constDefault constructor.
iVersionId

Construction and destruction

`TNetworkRegistrationV1()`

IMPORT_C TNetworkRegistrationV1();

Description

Default constructor.

Member data

`iRegStatus`

TRegistrationStatus iRegStatus;

Description

The current network registration status.

class TNetworkInfoV1 : public CTelephony::TEtelISVType;

Description

Defines information related to a mobile phone network.

Derivation

CTelephony::TEtelISVType - Specifies which version of an API parameter a client has used. For most ETel ISV...

CTelephony::TNetworkInfoV1 - Defines information related to a mobile phone network.

Members

Defined in CTelephony::TNetworkInfoV1:

TNetworkInfoV1()Default constructor.
iAccessOn GSM/WCDMA networks, the type of network access.
iAreaKnownOn GSM/WCDMA networks, boolean indicating whether the location area is known.
iBandInfoOn CDMA networks, the band and band class of the CDMA network operator.
iCdmaSIDOn CDMA networks, the system identity (SID) of the CDMA or AMPS network
iCellIdOn GSM/WCDMA networks, the cell identity code. Only valid when iAreaKnown is tru...
iCountryCodeThe MCC of the network.
iDisplayTagThe alpha-tag displayed when this is the serving network.
iLocationAreaCodeOn GSM/WCDMA networks, the location area code. Only valid when iAreaKnown is tru...
iLongNameOn GSM/WCDMA networks, the long name (up to 16 characters) of the network operat...
iModeMode of the network.
iNetworkIdThe network identity (NID in CDMA and MNC in GSM).
iShortNameOn GSM/WCDMA networks, the short name (up to 8 characters) of the network operat...
iStatusStatus of the network

Inherited from CTelephony::TEtelISVType:

VersionId()constDefault constructor.
iVersionId

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 iAreaKnown is true.

`iCellId`

TUint iCellId;

Description

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

class TNetworkNameV1 : public CTelephony::TEtelISVType;

Description

Defines the name network name.

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

Derivation

CTelephony::TEtelISVType - Specifies which version of an API parameter a client has used. For most ETel ISV...

CTelephony::TNetworkNameV1 - Defines the name network name.

Members

Defined in CTelephony::TNetworkNameV1:

TNetworkNameV1()Default constructor.
iNetworkNameThe displayed name (up to 16 characters) of the network provider.

Inherited from CTelephony::TEtelISVType:

VersionId()constDefault constructor.
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 : public CTelephony::TEtelISVType;

Description

Defines the current operator.

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

Derivation

CTelephony::TEtelISVType - Specifies which version of an API parameter a client has used. For most ETel ISV...

CTelephony::TOperatorNameV1 - Defines the current operator.

Members

Defined in CTelephony::TOperatorNameV1:

TOperatorNameV1()Default constructor.
iOperatorNameThe displayed name (up to 16 characters) of the network operator.

Inherited from CTelephony::TEtelISVType:

VersionId()constDefault constructor.
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 : public CTelephony::TEtelISVType;

Description

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

CTelephony::TNetworkInfoV2 should be used in preference to CTelephony::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

CTelephony::TEtelISVType - Specifies which version of an API parameter a client has used. For most ETel ISV...

CTelephony::TNetworkInfoV2 - Defines information related to a mobile phone network. CTelephony::TNetworkInfoV...

Members

Defined in CTelephony::TNetworkInfoV2:

TNetworkInfoV2()Default constructor.
iAccessOn GSM/WCDMA networks, the type of network access.
iAreaKnownOn GSM/WCDMA networks, boolean indicating whether the location area is known.
iBandInfoOn CDMA networks, the band and band class of the CDMA network operator.
iCdmaSIDOn CDMA networks, the system identity (SID) of the CDMA or AMPS network.
iCellIdOn GSM/WCDMA networks, the cell identity code. Only valid when iAreaKnown is tru...
iCountryCodeThe MCC of the network.
iDisplayTagThe alpha-tag displayed when this is the serving network.
iLocationAreaCodeOn GSM/WCDMA networks, the location area code. Only valid when iAreaKnown is tru...
iLongNameOn GSM/WCDMA networks, the long name (up to 20 characters) of the network operat...
iModeMode of the network.
iNetworkIdThe network identity (NID in CDMA and MNC in GSM).
iShortNameOn GSM/WCDMA networks, the short name (up to 10 characters) of the network opera...
iStatusStatus of the network.

Inherited from CTelephony::TEtelISVType:

VersionId()constDefault constructor.
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 iAreaKnown is true.

`iCellId`

TUint iCellId;

Description

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

class TNetworkNameV2 : public CTelephony::TEtelISVType;

Description

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

CTelephony::TNetworkNameV2 should be used in preference to CTelephony::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

CTelephony::TEtelISVType - Specifies which version of an API parameter a client has used. For most ETel ISV...

CTelephony::TNetworkNameV2 - Defines the name network name. CTelephony::TNetworkNameV2 differs from Version 1...

Members

Defined in CTelephony::TNetworkNameV2:

TNetworkNameV2()Default constructor.
iNetworkNameThe displayed name (up to 20 characters) of the network provider.

Inherited from CTelephony::TEtelISVType:

VersionId()constDefault constructor.
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 : public CTelephony::TEtelISVType;

Description

Defines information about the call forwarding service.

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

Derivation

CTelephony::TEtelISVType - Specifies which version of an API parameter a client has used. For most ETel ISV...

CTelephony::TCallForwardingSupplServicesV1 - Defines information about the call forwarding service.

Members

Defined in CTelephony::TCallForwardingSupplServicesV1:

TCallForwardingSupplServicesV1()Default constructor.
iCallForwardingThe status of the call forwarding supplementary service. It applies to the condi...
iCallForwardingConditionThe provisioned call forwarding condition to which iCallForwarding applies.

Inherited from CTelephony::TEtelISVType:

VersionId()constDefault constructor.
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(TRequestStatus &,const TCallForwardingCondition,TDes8 &,const TServiceGroup)const.

`iCallForwardingCondition`

TCallForwardingCondition iCallForwardingCondition;

Description

The provisioned call forwarding condition to which iCallForwarding applies.

class TCallBarringSupplServicesV1 : public CTelephony::TEtelISVType;

Description

Defines information about the call barring service.

Derivation

CTelephony::TEtelISVType - Specifies which version of an API parameter a client has used. For most ETel ISV...

CTelephony::TCallBarringSupplServicesV1 - Defines information about the call barring service.

Members

Defined in CTelephony::TCallBarringSupplServicesV1:

TCallBarringSupplServicesV1()Default constructor.
iCallBarringThe status of the call barring supplementary service. It applies to the conditio...
iCallBarringConditionThe provisioned call barring condition to which iCallBarring applies.

Inherited from CTelephony::TEtelISVType:

VersionId()constDefault constructor.
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(TRequestStatus &,const TCallBarringCondition,TDes8 &,const TServiceGroup)const.

`iCallBarringCondition`

TCallBarringCondition iCallBarringCondition;

Description

The provisioned call barring condition to which iCallBarring applies.

class TCallWaitingSupplServicesV1 : public CTelephony::TEtelISVType;

Description

Defines information about the call waiting service.

Derivation

CTelephony::TEtelISVType - Specifies which version of an API parameter a client has used. For most ETel ISV...

CTelephony::TCallWaitingSupplServicesV1 - Defines information about the call waiting service.

Members

Defined in CTelephony::TCallWaitingSupplServicesV1:

TCallWaitingSupplServicesV1()Default constructor.
iCallWaitingThe status of the call waiting supplementary service for the service group speci...

Inherited from CTelephony::TEtelISVType:

VersionId()constDefault constructor.
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(TRequestStatus &,TDes8 &,const TServiceGroup)const.

class TIdentityServiceV1 : public CTelephony::TEtelISVType;

Description

Defines the call identity service status.

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

Derivation

CTelephony::TEtelISVType - Specifies which version of an API parameter a client has used. For most ETel ISV...

CTelephony::TIdentityServiceV1 - Defines the call identity service status.

Members

Defined in CTelephony::TIdentityServiceV1:

TIdentityServiceV1()Default constructor.
iIdentityStatusThe status of the call identity service.

Inherited from CTelephony::TEtelISVType:

VersionId()constDefault constructor.
iVersionId

Construction and destruction

`TIdentityServiceV1()`

IMPORT_C TIdentityServiceV1();

Description

Default constructor.

Member data

`iIdentityStatus`

TIdentityServiceStatus iIdentityStatus;

Description

The status of the call identity service.

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.

n/a

Description

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

KMaxTelNumberSize

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.

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.

n/a

Description

Max size of Manufacturer Id.

KPhoneManufacturerIdSize

n/a

Description

Max size of Phone Model Id.

KPhoneModelIdSize

n/a

Description

Max size ofSerial Number.

KPhoneSerialNumberSize

n/a

Description

Maximum size of IMSI identifier.

KIMSISize

TFlightModeStatus

Description

The flight mode status.

`EFlightModeOff`	Flight mode is off.
`EFlightModeOn`	Flight mode is on.

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.

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.

TIccLock

Description

Pin 1/Pin 2 security

`ELockPin1`	Lock PIN1 on the ICC.
`ELockPin2`	Lock PIN2 on the ICC.

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.

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.

TPhoneLine

Description

Line types

`EVoiceLine`	Voice line.
`EDataLine`	Data line.
`EFaxLine`	Fax line.

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.

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

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.

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.

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.

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

n/a

Description

Maximum size of the calling party name.

KCallingNameSize

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.

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.

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.

n/a

Description

Maximum size of the network country code.

KNetworkCountryCodeSize

n/a

Description

Maximum size of the network identity..

KNetworkIdentitySize

n/a

Description

Maximum size of the network display tag..

KNetworkDisplayTagSize

n/a

Description

Maximum size of the short network name.

KNetworkShortNameSize

n/a

Description

Maximum size of the long network name.

KNetworkLongNameSize

n/a

Description

Maximum size of the short network name version 2.

KNetworkShortNameSizeV2

n/a

Description

Maximum size of the long network name version 2.

KNetworkLongNameSizeV2

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.

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

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.

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.

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.

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.

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

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.

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.

TServiceGroup

Description

Service group identifier.

`EVoiceService`	Voice service group
`EFaxService`	Fax service group
`EDataService`	Data service group

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.

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 `CTelephony::CancelAsync(TCancellationRequest)const` `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 `CTelephony::CancelAsync(TCancellationRequest)const` `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 `CTelephony::CancelAsync(TCancellationRequest)const` `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 `CTelephony::CancelAsync(TCancellationRequest)const` `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 `CTelephony::CancelAsync(TCancellationRequest)const` `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 `CTelephony::CancelAsync(TCancellationRequest)const` `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 `CTelephony::CancelAsync(TCancellationRequest)const` `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 `CTelephony::CancelAsync(TCancellationRequest)const` `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 `CTelephony::CancelAsync(TCancellationRequest)const` `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 `CTelephony::CancelAsync(TCancellationRequest)const` `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 `CTelephony::CancelAsync(TCancellationRequest)const` `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 `CTelephony::CancelAsync(TCancellationRequest)const` `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 `CTelephony::CancelAsync(TCancellationRequest)const` `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 `CTelephony::CancelAsync(TCancellationRequest)const` `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 `CTelephony::CancelAsync(TCancellationRequest)const` `CTelephony::EDataLineStatusChangeCancel` to cancel.

typedef TBuf<KMaxTelNumberSize> CTelephony::TTelNumber;

Description

A typedef to hold the telephone number.

typedef TPckg<TPhoneIdV1> CTelephony::TPhoneIdV1Pckg;

Description

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

typedef TPckg<TSubscriberIdV1> CTelephony::TSubscriberIdV1Pckg;

Description

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

typedef TPckg<TFlightModeV1> CTelephony::TFlightModeV1Pckg;

Description

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

typedef TPckg<TIndicatorV1> CTelephony::TIndicatorV1Pckg;

Description

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

typedef TPckg<TBatteryInfoV1> CTelephony::TBatteryInfoV1Pckg;

Description

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

typedef TPckg<TSignalStrengthV1> CTelephony::TSignalStrengthV1Pckg;

Description

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

typedef TPckg<TIccLockInfoV1> CTelephony::TIccLockInfoV1Pckg;

Description

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

typedef TPckg<TCallStatusV1> CTelephony::TCallStatusV1Pckg;

Description

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

typedef TPckg<TCallSelectionV1> CTelephony::TCallSelectionV1Pckg;

Description

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

typedef TPckg<TCallInfoV1> CTelephony::TCallInfoV1Pckg;

Description

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

typedef TPckg<TRemotePartyInfoV1> CTelephony::TRemotePartyInfoV1Pckg;

Description

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

typedef TPckg<TCallParamsV1> CTelephony::TCallParamsV1Pckg;

Description

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

typedef TPckg<TCallCapsV1> CTelephony::TCallCapsV1Pckg;

Description

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

typedef TPckg<TNetworkRegistrationV1> CTelephony::TNetworkRegistrationV1Pckg;

Description

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

typedef TPckg<TNetworkInfoV1> CTelephony::TNetworkInfoV1Pckg;

Description

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

typedef TPckg<TNetworkNameV1> CTelephony::TNetworkNameV1Pckg;

Description

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

typedef TPckg<TOperatorNameV1> CTelephony::TOperatorNameV1Pckg;

Description

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

typedef TPckg<TNetworkInfoV2> CTelephony::TNetworkInfoV2Pckg;

Description

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

typedef TPckg<TNetworkNameV2> CTelephony::TNetworkNameV2Pckg;

Description

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

typedef TPckg<TCallForwardingSupplServicesV1> CTelephony::TCallForwardingSupplServicesV1Pckg;

Description

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

typedef TPckg<TCallBarringSupplServicesV1> CTelephony::TCallBarringSupplServicesV1Pckg;

Description

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

typedef TPckg<TCallWaitingSupplServicesV1> CTelephony::TCallWaitingSupplServicesV1Pckg;

Description

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

typedef TPckg<TIdentityServiceV1> CTelephony::TIdentityServiceV1Pckg;

Description

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

Class CTelephony

Description

Derivation

Members

Construction and destruction

NewLC()

Description

Return value

NewL()

Description

Return value

Member functions

Version()const

Description

Return value

GetPhoneId(TRequestStatus &,TDes8 &)const

Description

Parameters

GetSubscriberId(TRequestStatus &,TDes8 &)const

Description

Parameters

GetFlightMode(TRequestStatus &,TDes8 &)const

Description

Parameters

GetIndicator(TRequestStatus &,TDes8 &)const

Description

Parameters

See also:

GetBatteryInfo(TRequestStatus &,TDes8 &)const

Description

Parameters

GetSignalStrength(TRequestStatus &,TDes8 &)const

Description

Parameters

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

Description

Parameters

SendDTMFTones(TRequestStatus &,const TDesC &)const

Description

Parameters

GetLineStatus(const TPhoneLine &,TDes8 &)const

Description

Parameters

Return value

GetCallInfo(TDes8 &,TDes8 &,TDes8 &)const

Description

Parameters

Return value

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

Description

Parameters

See also:

GetCallDynamicCaps(const TCallId &,TDes8 &)const

Description

Parameters

Return value

GetCallStatus(const TCallId &,TDes8 &)const

Description

Parameters

Return value

See also:

Hold(TRequestStatus &,const TCallId &)const

Description

Parameters

See also:

Resume(TRequestStatus &,const TCallId &)const

Description

Parameters

See also:

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

Description

Parameters

See also:

Hangup(TRequestStatus &,const TCallId &)const

Description

Parameters

See also:

AnswerIncomingCall(TRequestStatus &,TCallId &,const TPhoneLine)const

Description

Parameters

Class `CTelephony`

`NewLC()`

`NewL()`

`Version()const`

`GetPhoneId(TRequestStatus &,TDes8 &)const`

`GetSubscriberId(TRequestStatus &,TDes8 &)const`

`GetFlightMode(TRequestStatus &,TDes8 &)const`

`GetIndicator(TRequestStatus &,TDes8 &)const`

`GetBatteryInfo(TRequestStatus &,TDes8 &)const`

`GetSignalStrength(TRequestStatus &,TDes8 &)const`

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

`SendDTMFTones(TRequestStatus &,const TDesC &)const`

`GetLineStatus(const TPhoneLine &,TDes8 &)const`

`GetCallInfo(TDes8 &,TDes8 &,TDes8 &)const`

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

`GetCallDynamicCaps(const TCallId &,TDes8 &)const`

`GetCallStatus(const TCallId &,TDes8 &)const`

`Hold(TRequestStatus &,const TCallId &)const`

`Resume(TRequestStatus &,const TCallId &)const`

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

`Hangup(TRequestStatus &,const TCallId &)const`

`AnswerIncomingCall(TRequestStatus &,TCallId &,const TPhoneLine)const`

`GetNetworkRegistrationStatus(TRequestStatus &,TDes8 &)const`

`GetCurrentNetworkInfo(TRequestStatus &,TDes8 &)const`

`GetCurrentNetworkName(TRequestStatus &,TDes8 &)const`

`GetOperatorName(TRequestStatus &,TDes8 &)const`

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

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

`GetCallWaitingStatus(TRequestStatus &,TDes8 &,const TServiceGroup)const`

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

`CancelAsync(TCancellationRequest)const`

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

`FindDeviceStatus(TInt &)`

`EstablishDataCall(TInt &,const TDesC &)`

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

`TerminateDataCall()`

`ReceiveDataCall(TInt &)`

`ReceiveDataCall(TRequestStatus &,TInt &)`

`CancelEstablishDataCall()`

`CancelReceiveDataCall()`

Class `TEtelISVType`

`VersionId()const`

`iVersionId`

Class `TTelAddress`