![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
Section Contents
CActive |
Abstract: active object: provides facilities to encapsulate an asynchronous service, and to handle its completion using RunL(). |
etelbgsm.h
gsmbas.lib
This class is used to retrieve asynchronously all the networks detected by a phone. The results are retrieved in a CGsmDetectedNetworkResults object, which is owned by this class.
The use of this class is discussed in Asynchronously retrieving detected networks.
This class is not intended for user derivation.
static CBasicGsmRetrieveDetectedNetworks* NewL(RBasicGsmPhone& aPhone);
Use this function to create a new CBasicGsmRetrieveDetectedNetworks active object. If there is insufficient memory available to create this object, the function leaves.
RBasicGsmPhone& aPhone |
The phone for which all detected networks are to be found. |
CBasicGsmRetrieveDetectedNetworks* |
A pointer to the newly created active object for retrieving the detected networks |
~CBasicGsmRetrieveDetectedNetworks();
The destructor invokes Cancel() to cancel any outstanding request, and removes the object from the active scheduler. It then frees all resources owned by this object, prior to its destruction.
void Start(TRequestStatus& aStatus);
This function initiates the detected network retrieval process.
TRequestStatus& aStatus |
The variable that indicates when the detected network information retrieval is complete. |
CGsmDetectedNetworkResults* RetrieveResults() const;
This function retrieves a pointer to the container class CGsmDetectedNetworkResults, which contains the search results.
CGsmDetectedNetworkResults* |
A pointer to the detected network retrieval results. |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |