Symbian^3 Application Developer Library >

CRetrieveMobilePhoneCFList Class Reference

class CRetrieveMobilePhoneCFList : public CAsyncRetrievePhoneList

Retrieves the Call Forwarding status list from the phone.

Due to the probable time taken to retrieve a list, clients must use an asynchronous approach based around the use of this object.

Inherits from

Nested Classes and Structures

Public Member Functions
~CRetrieveMobilePhoneCFList ()
IMPORT_C CRetrieveMobilePhoneCFList * NewL ( RMobilePhone &)
IMPORT_C CMobilePhoneCFList * RetrieveListL ()
IMPORT_C void Start ( TRequestStatus &, RMobilePhone::TMobilePhoneCFCondition , RMobilePhone::TMobileInfoLocation )
IMPORT_C void Start ( TRequestStatus &, RMobilePhone::TMobilePhoneCFCondition , RMobilePhone::TMobileService , RMobilePhone::TMobileInfoLocation )
Protected Member Functions
CRetrieveMobilePhoneCFList ( RMobilePhone &)
void ConstructL ()
void RestoreListL ()
Inherited Functions
CActive::CActive(TInt)
CActive::Cancel()
CActive::Deque()
CActive::Extension_(TUint,TAny *&,TAny *)
CActive::IsActive()const
CActive::IsAdded()const
CActive::Priority()const
CActive::RunError(TInt)
CActive::SetActive()
CActive::SetPriority(TInt)
CActive::~CActive()
CAsyncRetrievePhoneList::CAsyncRetrievePhoneList(RMobilePhone &)
CAsyncRetrievePhoneList::CancelReq(TInt,TInt)
CAsyncRetrievePhoneList::Get(TInt,TRequestStatus &,TDes8 &,TDes8 &)
CAsyncRetrievePhoneList::~CAsyncRetrievePhoneList()
CAsyncRetrieveVariableLengthBufferV2::CAsyncRetrieveVariableLengthBufferV2()
CAsyncRetrieveVariableLengthBufferV2::CompleteIfInUse(TRequestStatus &)
CAsyncRetrieveVariableLengthBufferV2::FreeBuffer()
CAsyncRetrieveVariableLengthBufferV2::Start(TRequestStatus &,TDes8 *,TDes8 *)
CAsyncRetrieveVariableLengthBufferV2::~CAsyncRetrieveVariableLengthBufferV2()
CAsyncRetrieveWithClientIds::CAsyncRetrieveWithClientIds(TInt,TInt)
CBase::CBase()
CBase::Delete(CBase *)
CBase::operator new(TUint)
CBase::operator new(TUint,TAny *)
CBase::operator new(TUint,TLeave)
CBase::operator new(TUint,TLeave,TUint)
CBase::operator new(TUint,TUint)
CBase::~CBase()
Inherited Enumerations
CActive:TPriority
CAsyncRetrieveVariableLengthBufferV2:@151
Private Attributes
TPckgBuf < TGetCallForwardingRequest > iCFRequestData
CMobilePhoneCFList * iResults
Inherited Attributes
CActive::iStatus
CAsyncRetrievePhoneList::iPhone
CAsyncRetrieveVariableLengthBufferV2::iIpcCancel
CAsyncRetrieveVariableLengthBufferV2::iIpcPhase1
CAsyncRetrieveVariableLengthBufferV2::iIpcPhase2
CAsyncRetrieveVariableLengthBufferV2::iResultsBuf
CAsyncRetrieveVariableLengthBufferV2::iResultsPtr
CAsyncRetrieveVariableLengthBufferV2::iState
CAsyncRetrieveWithClientIds::iId

Constructor & Destructor Documentation

CRetrieveMobilePhoneCFList(RMobilePhone &)

CRetrieveMobilePhoneCFList ( RMobilePhone & aPhone ) [protected]

Parameters

RMobilePhone & aPhone

~CRetrieveMobilePhoneCFList()

IMPORT_C ~CRetrieveMobilePhoneCFList ( )

The destructor frees all resources owned by the object, prior to its destruction.

Member Functions Documentation

ConstructL()

void ConstructL ( ) [protected]

NewL(RMobilePhone &)

IMPORT_C CRetrieveMobilePhoneCFList * NewL ( RMobilePhone & aPhone ) [static]

This member function creates an instance of the CRetrieveMobilePhoneCFList class.

Parameters

RMobilePhone & aPhone A reference to the RMobilePhone sub-session as it is this sub-session that the list retrieval class will operate on.

RestoreListL()

void RestoreListL ( ) [protected, virtual]

This method restores a list from a buffer that contains the streamed version of the list

RetrieveListL()

IMPORT_C CMobilePhoneCFList * RetrieveListL ( )

This member function provides the client with a handle to the list class retrieved from the phone. The client will call this member function once Start() has completed. The retrieved list will consist of an entry per basic service group per specified CF condition. When the client calls this member function the ownership of the CMobilePhoneCFList object will transfer to the client, so the client is then responsible for eventual deletion of this object.

leave
KErrNotFound If there is no valid list object to return to the client.

Start(TRequestStatus &, RMobilePhone::TMobilePhoneCFCondition, RMobilePhone::TMobileInfoLocation)

IMPORT_C void Start ( TRequestStatus & aReqStatus,
RMobilePhone::TMobilePhoneCFCondition aCondition,
RMobilePhone::TMobileInfoLocation aLocation = RMobilePhone::EInfoLocationCachePreferred
)

This method starts the retrieval of the call forwarding status list

7.0s. Deprecated, other CRetrieveMobilePhoneCFList::Start overload should be used instead
capability
NetworkServices
capability
ReadDeviceData

Parameters

TRequestStatus & aReqStatus
RMobilePhone::TMobilePhoneCFCondition aCondition
RMobilePhone::TMobileInfoLocation aLocation = RMobilePhone::EInfoLocationCachePreferred

Start(TRequestStatus &, RMobilePhone::TMobilePhoneCFCondition, RMobilePhone::TMobileService, RMobilePhone::TMobileInfoLocation)

IMPORT_C void Start ( TRequestStatus & aReqStatus,
RMobilePhone::TMobilePhoneCFCondition aCondition,
RMobilePhone::TMobileService aServiceGroup,
RMobilePhone::TMobileInfoLocation aLocation = RMobilePhone::EInfoLocationCachePreferred
)

7.0s. Deprecated use other overload

This method starts the retrieval of the call forwarding status list. If the list is empty then KErrNone is returned.
capability
NetworkServices
capability
ReadDeviceData

Parameters

TRequestStatus & aReqStatus
RMobilePhone::TMobilePhoneCFCondition aCondition
RMobilePhone::TMobileService aServiceGroup
RMobilePhone::TMobileInfoLocation aLocation = RMobilePhone::EInfoLocationCachePreferred

Member Data Documentation

TPckgBuf< TGetCallForwardingRequest > iCFRequestData

TPckgBuf < TGetCallForwardingRequest > iCFRequestData [private]

CMobilePhoneCFList * iResults

CMobilePhoneCFList * iResults [private]

Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License v1.0.