CRetrievePcktMbmsMonitoredServices Class Reference

class CRetrievePcktMbmsMonitoredServices : public CAsyncRetrieveWithClientIds

Reads MBMS monitored service list from the phone.

Enables the client to retrieve all the monitored service list in a single call. A CPcktMbmsMonitoredServiceList object is returned to the client. Due to the probable time taken to retrieve a list, clients must use an asynchronous approach.

Public Member Functions
~CRetrievePcktMbmsMonitoredServices ()
IMPORT_C CRetrievePcktMbmsMonitoredServices * NewL ( RPacketService &)
IMPORT_C CPcktMbmsMonitoredServiceList * RetrieveListL ()
IMPORT_C void Start ( TRequestStatus &)
Protected Member Functions
CRetrievePcktMbmsMonitoredServices ( RPacketService &)
void ConstructL ()
void RestoreListL ()
Private Member Functions
void CancelReq ( TInt , TInt )
void Get ( TInt , TRequestStatus &, TDes8 &, TDes8 &)
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()
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:@104
Private Attributes
CPcktMbmsMonitoredServiceList * iResults
RPacketService & iService
Inherited Attributes
CActive::iStatus
CAsyncRetrieveVariableLengthBufferV2::iIpcCancel
CAsyncRetrieveVariableLengthBufferV2::iIpcPhase1
CAsyncRetrieveVariableLengthBufferV2::iIpcPhase2
CAsyncRetrieveVariableLengthBufferV2::iResultsBuf
CAsyncRetrieveVariableLengthBufferV2::iResultsPtr
CAsyncRetrieveVariableLengthBufferV2::iState
CAsyncRetrieveWithClientIds::iId

Constructor & Destructor Documentation

CRetrievePcktMbmsMonitoredServices(RPacketService &)

CRetrievePcktMbmsMonitoredServices ( RPacketService & aService ) [protected]

Standard constructor; initialises the data members.

Parameters

RPacketService & aService

~CRetrievePcktMbmsMonitoredServices()

IMPORT_C ~CRetrievePcktMbmsMonitoredServices ( )

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

Member Functions Documentation

CancelReq(TInt, TInt)

void CancelReq ( TInt aIpc1,
TInt aIpc2
) [private, virtual]

Cancels previously issued request

Parameters

TInt aIpc1
TInt aIpc2

ConstructL()

void ConstructL ( ) [protected]

Part of 2 phase construction, assigns the IPCs to be used in 2 phase retrieval mechanism.

Get(TInt, TRequestStatus &, TDes8 &, TDes8 &)

void Get ( TInt aIpc,
TRequestStatus & aReqStatus,
TDes8 & aDes1,
TDes8 & aDes2
) [private, virtual]

Sends a request through the sub-session this object was created with.

Parameters

TInt aIpc
TRequestStatus & aReqStatus
TDes8 & aDes1
TDes8 & aDes2

NewL(RPacketService &)

IMPORT_C CRetrievePcktMbmsMonitoredServices * NewL ( RPacketService & aService ) [static]
Creates an instance of the CActive derived CRetrievePcktMbmsMonitoredServices class.
capability
None

Parameters

RPacketService & aService An instance of RPacketService over which the list retrieval class operates.

RestoreListL()

void RestoreListL ( ) [protected, virtual]

Restores a list from a buffer that contains the streamed version of the list

RetrieveListL()

IMPORT_C CPcktMbmsMonitoredServiceList * RetrieveListL ( )

Provides the client with a handle to the appropriate MBMS service availability list class retrieved. The client will call this function once Start() has completed. The ownership of the list object is transferred to the client and the client is responsible for eventual deletion of this object.

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

Start(TRequestStatus &)

IMPORT_C void Start ( TRequestStatus & aReqStatus )

Starts the two-phase list retrieval of all entries within the store.

capability
ReadDeviceData

Parameters

TRequestStatus & aReqStatus On completion, the status of the request; KErrNone if successful, KErrNotSupported if the phone does not support access to an MBMS service availability list and KErrNotFound if the list does not exist. If the list is empty then KErrNone is returned.

Member Data Documentation

CPcktMbmsMonitoredServiceList * iResults

CPcktMbmsMonitoredServiceList * iResults [private]

Holds the list of services retrieved from the TSY

RPacketService & iService

RPacketService & iService [private]

Holds a reference to packet service object