![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
Section Contents
MBasicGsmPhoneNetwork |
Mixin: interface for accessing network capabilities |
etelbgsm.h
gsmbas.lib
This class defines the protocol for accessing GSM network functionality.
protected: MBasicGsmPhoneNetwork()
The default C++ constructor is protected, which prevents objects of this class from being constructed. This class is intended only as an abstract base for other classes.
virtual TInt GetNetworkInfoCaps(TNetworkCapsFlags& aCaps) const=0;
This function retrieves the static network capabilities.
TNetworkCapsFlags& aCaps |
On return, contains the static network capabilities |
TInt |
An error code: see System error codes. |
virtual TInt GetNetworkRegistrationStatus(TRegistrationStatus& aRegistrationStatus) const=0;
This function retrieves information about the current network registration status.
TRegistrationStatus& aRegistrationStatus |
On return, contains the network registration status. |
TInt |
An error code: see System error codes. |
virtual void NotifyChangeOfNetworkRegistrationStatus(TRequestStatus& aStatus,TRegistrationStatus& aRegistrationStatus)=0;
This function provides notification of changes to the current network registration status.
TRequestStatus& aStatus |
A variable that indicates the completion status of the request. |
TRegistrationStatus& aRegistrationStatus |
On request completion, contains the current registration status information. |
virtual void NotifyChangeOfNetworkRegistrationStatusCancel() const=0;
This function cancels an outstanding request to be notified about changes to the current network registration status, placed with the NotifyChangeOfNetworkRegistrationStatus() function.
virtual TInt SetNetworkMode(const TNetworkSetMode aMode) const=0;
This function synchronously sets the current network search mode.
const TNetworkSetMode aMode |
The new network search mode. |
TInt |
An error code: see System error codes. |
virtual void SetNetworkMode(TRequestStatus& aStatus,const TNetworkSetMode aMode)=0;
This function asynchronously sets the current network search mode.
TRequestStatus& aStatus |
A variable that indicates the completion status of the request. |
const TNetworkSetMode aMode |
The new network search mode. |
virtual void SetNetworkModeCancel() const=0;
This function cancels an outstanding request to set the network search mode, placed with the SetNetworkMode() function.
virtual TInt GetNetworkSearchMode(TNetworkSetMode& aMode) const=0;
This function retrieves the current network search mode.
TNetworkSetMode& aMode |
On return, contains the network search mode. |
TInt |
An error code: see System error codes. |
virtual void NotifyChangeOfNetworkSearchMode(TRequestStatus& aStatus,TNetworkSetMode& aMode)=0;
This function provides notification of changes to the network search mode.
TRequestStatus& aStatus |
A variable that indicates the completion status of the request. |
TNetworkSetMode& aMode |
On request completion, contains the current network search mode. |
virtual void NotifyChangeOfNetworkSearchModeCancel() const=0;
This function cancels an outstanding network search mode notification request, placed with the NotifyChangeOfNetworkSearchMode() function.
virtual TInt EnumerateDetectedNetworks(TInt& aNetworkCnt) const=0;
This function retrieves the number of networks currently available to the phone.
TInt& aNetworkCnt |
On return, contains the number of networks available to the phone. |
TInt |
An error code: see System error codes. |
virtual void EnumerateDetectedNetworks(TRequestStatus& aStatus, TInt& aNetworkCnt)=0;
This function retrieves the number of networks currently available to the phone.
TRequestStatus& aStatus |
A variable that indicates the completion status of the request. |
TInt& aNetworkCnt |
On request completion, contains the number of networks available to the phone. |
virtual void EnumerateDetectedNetworksCancel() const=0;
This function cancels an outstanding request to enumerate the detected networks, made using the asynchronous version of the EnumerateDetectedNetworks() function.
virtual TInt GetDetectedNetworkInfo(const TInt aIndex,TNetworkInfo& aNetworkInfo) const=0;
This function retrieves information about a currently detected network.
const TInt aIndex |
The index of the network for which information is required. The valid range for the index is between 0 and (n-1), where n is the number returned by the EnumerateDetectedNetworks() function. |
TNetworkInfo& aNetworkInfo |
On return, contains information about the selected network. |
TInt |
An error code: see System error codes. |
virtual void GetDetectedNetworkInfo(TRequestStatus& aStatus, const TInt aIndex,TNetworkInfo& aNetworkInfo)=0;
This function retrieves information about a currently detected network.
TRequestStatus& aStatus |
A variable that indicates the completion status of the request. |
const TInt aIndex |
The index of the network for which information is required. The valid range for the index is between 0 and (n-1), where n is the number returned by the EnumerateDetectedNetworks() function. |
TNetworkInfo& aNetworkInfo |
On request completion, contains information about the selected network. |
virtual void GetDetectedNetworkInfoCancel() const=0;
This function cancels an outstanding network information retrieval request, placed using the asynchronous variant of the GetNetworkInfo() function.
virtual CGsmDetectedNetworkResults* RetrieveDetectedNetworksLC()=0;
This function synchronously returns information about all the detected networks. It may be used in place of the combination of EnumerateDetectedNetworks() and GetDetectedNetworkInfo() functions, and eliminates the small possibility of the Detected Network information changing before the GetDetectedNetworkInfo() function completes.
CGsmDetectedNetworkResults* |
On return, contains the information about all the detected networks. This information is then available client-side. |
virtual TInt SetManualNetwork(const TBscNetworkId aNetworkId) const=0;
This function sets a network as the current network.
const TBscNetworkId aNetworkId |
The ID of the network to be set as the current network. |
TInt |
An error code: see System error codes. |
virtual void SetManualNetwork(TRequestStatus& aStatus,const TBscNetworkId aNetworkId)=0;
This function sets a network as the current network.
TRequestStatus& aStatus |
A variable that indicates the completion status of the request. |
const TBscNetworkId aNetworkId |
The ID of the network to be set as the current network. |
virtual void SetManualNetworkCancel() const=0;
This function cancels an outstanding request to set the current network, made using the asynchronous variant of the SetManualNetwork() function.
virtual TInt GetCurrentNetworkInfo(TCurrentNetworkInfo& aNetworkInfo) const=0;
This function retrieves information about the current network.
TCurrentNetworkInfo& aNetworkInfo |
On return, contains information about the current network. |
TInt |
An error code: see System error codes. |
virtual void NotifyChangeOfCurrentNetwork(TRequestStatus& aStatus,TCurrentNetworkInfo& aNetworkInfo)=0;
This function provides notification when the current network information changes.
TRequestStatus& aStatus |
A variable that indicates the completion status of the request. |
TCurrentNetworkInfo& aNetworkInfo |
On request completion, contains the new network information. |
virtual void NotifyChangeOfCurrentNetworkCancel() const=0;
This function cancels an outstanding request to be notified about changes to the current network information, placed with the NotifyChangeOfCurrentNetwork() function.
The ME attempts to register to the detected networks in the priority order specified by the preferred networks list. |
|
The ME registers the network stored in the "Registered PLMN" field on the SIM. |
Indicates that functionality to obtain network information from the TSY is available. |
|
Indicates that the short network name is available when requesting available network information. |
|
Indicates that the long network name is available when requesting available network information. |
|
Indicates that current network information is available. |
Not registered. The ME is not currently searching a new network to register with. |
|
Registered on home network. |
|
Not registered, but the ME is currently searching a new network to register with. |
|
Registration denied. |
|
Registration status is unknown. |
|
Registered, roaming. |
Status is unknown. |
|
A network that the ME is allowed to register with. |
|
The currently registered network. |
|
A network that the ME is not allowed to register with. |
Size of the short network name (8 characters). |
|
Size of the long network name (16 characters). |
TUint iNetworkInfoCaps |
Defines the network capabilities as a bitmask of the TNetworkInfoCaps constants. |
TNetworkInfo iNetworkInfo |
Information about the current network. |
TUint iLocationAreaCode |
Location area code. |
TUint iCellId |
Cell identity code. |
Section Contents
MBasicGsmPhoneNetwork::TBscNetworkId |
Scoped class: Network ID information |
etelbgsm.h
gsmbas.lib
Defines a structure for network ID information, including the country and network code for the mobile subscriber.
The class does not declare a constructor.
TUint iMCC |
A three decimal digit mobile country code converted to Binary Coded Decimal representation. |
TUint iMNC |
A two decimal digit mobile network code converted to Binary Coded Decimal representation. |
Section Contents
MBasicGsmPhoneNetwork::TNetworkInfo |
Scoped class: Detected network information |
etelbgsm.h
gsmbas.lib
Defines a structure for containing the information about detected networks.
TNetworkInfo();
The class declares a default empty constructor.
TBscNetworkId iId |
Network identification number. |
TNetworkStatus iStatus |
Status of the network. |
TBuf8<KShortNetworkNameSize> iShortName |
Short network name. |
TBuf8<KLongNetworkNameSize> iLongName |
Long network name. |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |