| class RPacketMbmsContext : public RPacketContext |
Defines the MBMS context and the configuration of a connection to the network's packet-switched service. The functionality associated with the context of a MBMS connection is inherited from RPacketContext class. The behaviour of OpenNewContext API is redefined. Every instance of this class has RPacketService as a base class.
| Public Member Functions | |
|---|---|
| RPacketMbmsContext () | |
| IMPORT_C void | Close () |
| IMPORT_C TInt | OpenNewContext ( RPacketService &, TDes &) |
| IMPORT_C void | UpdateMbmsSessionList ( TRequestStatus &, const TMbmsAction , const TMbmsSessionId ) |
| Public Member Type Definitions | |
|---|---|
| typedef | TPckg < TContextConfigMbmsV1 > TContextConfigMbmsV1Pckg |
| Inherited Attributes | |
|---|---|
| RPacketContext::iEtelPacketContextPtrHolder | |
| RTelSubSessionBase::iPtrHolder | |
| IMPORT_C void | Close | ( | ) |
Closes the client's current sub-session with ETel. Any outstanding requests the client may have with ETel (notifications, for example) will be automatically destroyed.
An opened RPacketMbmsContext must be closed explicitly by calling Close() to prevent a resource (memory) leak.
| IMPORT_C TInt | OpenNewContext | ( | RPacketService & | aPacketNetwork, |
| TDes & | aContextName | |||
| ) | ||||
Creates a MBMS context (i.e. RPacketMbmsContext ) on an existing RPacketService connection.
The TSY will return KErrUmtsMaxNumOfContextExceededByPhone if the number of MBMS contexts supported by the phone is exceeded. The TSY will return KErrUmtsMaxNumOfContextExceededByNetwork if the number of MBMS contexts supported by the network is exceeded.
An opened RPacketMbmsContext must be closed explicitly by calling Close() to prevent a resource (memory) leak.
| RPacketService & aPacketNetwork | An RPacketMbmsContext may only be opened from an existing RPacketService subsession. A client application must therefore pass a reference to their previously instantiated RPacketService object. |
| TDes & aContextName | Set as the hint for the TSY to identify the Mbms Context. |
| IMPORT_C void | UpdateMbmsSessionList | ( | TRequestStatus & | aStatus, |
| const TMbmsAction | aAction, | |||
| const TMbmsSessionId | aSessionId = 0 | |||
| ) | const | |||
Provides MBMS client the facility to add a new session to be received or remove an existing session to/from the mbms services table.
| TRequestStatus & aStatus | On completion, KErrNone if successful. Completes with KErrNotFound, if the supplied session is invalid for removal. In the above case the action would be ERemoveEntries. Completes with KErrMbmsImpreciseServiceEntries, if some of the valid sessions cannot be removed. In the above case the action would be ERemoveAllEntries. Or a system-wide error code if not successful. |
| const TMbmsAction aAction | The session action information which can be either add,remove or removeall. |
| const TMbmsSessionId aSessionId = 0 | The MBMS session identifier which need to be received or removed. |
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.