Standard constructor.

Causes the phone to attempt an attach to the packet network, if it is not already attached.

This is an asynchronous function since attachment may take anything up to one minute in the worst case scenario.

Attachment may take anything up to one minute in the worst case scenario.

It is not often necessary to use this function as there is a separate setting to tell the phone either to attach at start-up, or to attach when a context is created. It is intended that this function only be utilized if the user has an option to choose exactly when to attach and detach.

Use RTelSubSessionBase::CancelAsyncRequest(EPacketAttach) to cancel a previously placed asynchronous Attach() request.

Closes the RPacketService subsession.

An opened RPacketService must be closed explicitily by calling Close() to prevent a resource (memory) leak.

ConstructL for the RPacketService class

This asynchronous method may be called by the client application.

Invokes a packet network deactivation of all associated contexts sharing the same network interaface (NIF) with the specified context (aContextName argument) using the tear down indication when requesting the deactivation operation for the specified context.

Destruct() method for the RPacketService class

Causes the phone to attempt to detach from the packet network, if it is not already.

This is an asynchronous function.

Use RTelSubSessionBase::CancelAsyncRequest(EPacketDetach) to cancel a previously placed asynchronous Detach() request.

Retrieves both the number of opened contexts in the TSY, whether active or inactive, and the maximum possible number of contexts.

This is an asynchronous function.

Allows a client to determine whether they can open a new context.

The maximum number of possible contexts is not the maximum number of simultaneously active contexts, but the total number allowed. (The maximum possible number of simultaneously active contexts is currently limited to 1). Clients are thus able to determine whether they can open a new context or not.

Use RTelSubSessionBase::CancelAsyncRequest(EPacketEnumerateContexts) to cancel a previously placed asynchronous EnumerateContexts() request.

This asynchronous method may be called by the client application.

It retrieves the number of contexts sharing a particular network interface, including the primary context (if it still exists) and the context specified in aExistingContextName.

Retrieves both, the number of services in the Mbms Active service list in the TSY, and the maximum possible number of Mbms Active services.

This is an asynchronous function.

Use RTelSubSessionBase::CancelAsyncRequest(EPacketEnumerateMbmsActiveServiceList) to cancel a previously placed asynchronous EnumerateMbmsActiveServiceList() request.

Retrieves both, the number of services in the Mbms Monitor service list in the TSY, and the maximum possible number of Mbms Monitor services.

This is an asynchronous function.

Use RTelSubSessionBase::CancelAsyncRequest(EPacketEnumerateMbmsMonitorServiceList) to cancel a previously placed asynchronous EnumerateMbmsMonitorServiceList() request.

This asynchronous method may be called by the client application.

It returns the number of defined packet network interfaces in the parameter aCount. One network interface (NIF) exists per local IP address, but there may be several PDP contexts per NIF, i.e. one primary and several secondary contexts, all sharing the IP address and other configuration information such as PDP type and APN.

Retrieves the current mode of GPRS Attach mode, in version 1 of the API.

The asynchronous version should be used from v7.0S.

This asynchronous method may be called by the client. It has superseded the synchronous variant of this method. It will retrieve the current mode of the packet network attach operation.

Retrieves information about a particular context.

It is usual to use this function in conjunction with the EnumerateContexts() function, which returns the current number of opened contexts.

This is an asynchronous function.

Use RTelSubSessionBase::CancelAsyncRequest(EPacketGetContextInfo) to cancel a previously placed asynchronous GetContextInfo() request.

This asynchronous method may be called by the client application.

It retrieves the name of the context specified by aIndex for a particular network interface, which is determined by aExistingContextName

This asynchronous method may be called by the client application. It returns the current packet network release mode(Release97/98, Release 99 or Release 4).

Retrieves the default context parameters that are stored in the phone, in version 1 of the API.

The asynchronous version should be used from v7.0S.

This asynchronous method may be called by the client. It has superseded the synchronous variant of this method.

It will retrieve the default context parameters that are stored in the ME.

Retrieves those capabilities of the TSY/phone that are dynamic.

This is a synchronous function.

Gets both the current class and the highest class of the mobile phone.

This is an asynchronous function.

Use RTelSubSessionBase::CancelAsyncRequest(EPacketGetMSClass) to cancel a previously placed asynchronous GetMSClass() request.

Retrieves the MBMS network status of the phone. The indication of cell support for MBMS feature is only known from GMM Attach response from network or during Routing Area update. A consequence of this is that it is required for the UE to be in GMM Attach mode in order for either of these messages to be received. If the UE is not in GMM ATTACH then it is unable to determine MBMS network support.

There can be 3 states that MBMS feature availability could return, Unknown - when UE is not GMM Attached. Supported - When UE is GMM Attached and it is known that cell supports MBMS. Not Supported - When UE is GMM Attached and it is know that cell does not support MBMS.

This is an asynchronous function.

Use RTelSubSessionBase::CancelAsyncRequest(EPacketGetMbmsNetworkServiceStatus) to cancel a previously placed asynchronous GetMbmsNetworkServiceStatus() request.

This asynchronous method may be called by the client application. It retrieves information about the network interface specified by the aIndex parameter. It is usual to use this function in conjunction with the EnumerateNifs() method, which returns the current number of defined packet Network interfaces in its 'aCount' argument.

Retrieves the current registration status of the phone on the packet network.

This is an asynchronous function.

Use RTelSubSessionBase::CancelAsyncRequest(EPacketGetNtwkRegStatus) to cancel a previously placed asynchronous GetNtwkRegStatus() request.

Note that the synchronous variant of this method is deprecated. The asynchronous variant instead should be used.

Retrieves the currently selected preferred bearer to attach to when in Class C operation. The TSY should cache this value, so the function should return quickly hence there is no need for an asynchronous version.

This asynchronous function retrieves the currently selected preferred bearer to attach to when in Class C operation.

Retrieves those capabilities of the TSY/phone that are static.

This is a synchronous function.

Gets the status of the current packet service.

This is a synchronous function.

Notifies the client when there is a change in the current mode of the packet network attach operation.

Allows a client to be notified whenever a change in the status of the packet network registration is detected.

This is an asynchronous function.

Once the notification completes, the client must then re-post the notification if they wish to continue receiving further notifications.

Use RTelSubSessionBase::CancelAsyncRequest(EPacketNotifyChangeOfNtwkRegStatus) to cancel a previously placed asynchronous NotifyChangeOfNtwkRegStatus() request.

Completes when the phone receives a request from the packet network to activate a PDP context.

This is an asynchronous function.

Depending on the type of network, the aContextParameters may contain the PDP type requested, the PDP address for this context, and possibly the Access Point Name (APN) of the gateway to connect to.

To determine how to correctly unpack the aContextParameters descriptor inside the TSY, the TSY must first cast the descriptor to a TPacketDataConfigBase pointer and check whether ExtensionId() returns KConfigGPRS, KConfigCDMA or KConfigRel99Rel4. The TSY will then cast the descriptor to the correct TPacketDataConfigBase-derived class.

Once the notification completes, the client must then re-post the notification if they wish to continue receiving further notifications.

Use RTelSubSessionBase::CancelAsyncRequest(EPacketNotifyContextActivationRequested) to cancel a previously placed asynchronous NotifyContextActivationRequested() request.

Notifies the client whenever a new context ( RPacketContext ) is configured on the phone by a client using RPacketContext::SetConfig() .

This is an asynchronous function.

Once the notification completes, the client must then re-post the notification if they wish to continue receiving further notifications.

Use RTelSubSessionBase::CancelAsyncRequest(EPacketNotifyContextAdded) to cancel a previously placed asynchronous NotifyContextAdded() request.

Completes when the dynamic packet data capabilities change.

This is an asynchronous function.

Once the notification completes, the client must then re-post the notification if they wish to continue receiving further notifications.

A common usage of the dynamic capabilities functions would be for GetDynamicCaps() to be called first to retrieve the current set of capabilities, and then the NotifyDynamicCapsChange() request to be posted to be kept informed of any changes.

Use RTelSubSessionBase::CancelAsyncRequest(EPacketNotifyDynamicCapsChange) to cancel a previously placed asynchronous NotifyDynamicCapsChange() request.

Completes when there is a change in the current GPRS class of the mobile station.

This is an asynchronous function.

Once the notification completes, the client must then re-post the notification if they wish to continue receiving further notifications.

Use RTelSubSessionBase::CancelAsyncRequest(EPacketNotifyMSClassChange) to cancel a previously placed asynchronous NotifyMSClassChange() request.

Allows a client to be notified whenever a change in the MBMS network service status identified. There can be 3 states that MBMS feature availability could return, Unknown - when UE is not GMM Attached. Supported - When UE is GMM Attached and it is known that cell supports MBMS. Not Supported - When UE is GMM Attached and it is known that cell does not support MBMS.

This is an asynchronous function.

Once the notification completes, the client must re-post the notification if the client wish to continue receiving further notifications.

Use RTelSubSessionBase::CancelAsyncRequest(EPacketNotifyMbmsNetworkServiceStatusChange) to cancel a previously placed asynchronous NotifyMbmsNetworkServiceStatusChange() request.

Notifies the client that changes have been made to the MBMS Service availability list. When it completes, it does not return the new version of the list so the client will have to retrieve the list again if interested in the new list.

This asynchronous notification function may be called by the client.

It completes if the packet release mode of the network changes.

Allows a client to be notified of a change in the status of the connection to the packet service.

This is an asynchronous function.

Once the notification completes, the client must then re-post the notification if they wish to continue receiving further notifications.

Use RTelSubSessionBase::CancelAsyncRequest(EPacketNotifyStatusChange) to cancel a previously placed asynchronous NotifyStatusChange() request.

Creates a RPacketService subsession from an existing RPhone session.

An opened RPacketService must be closed explicitily by calling Close() to prevent a resource (memory) leak.

This is an internal API method. It is not intended for direct client access. It is called from RPacketContext::OpenNewSecondaryContext() .

It passes the name of the context (which is to spawn a secondary context) to the TSY. This alerts the TSY to the fact that the next context creation call is going to be for a secondary context.

Causes the phone to reject the network's request for a PDP context activation.

This is an asynchronous function.

There is no corresponding "accept" message for the phone to send. To accept, the phone should simply begin to activate a PDP context with the appropriate IP address before the network's timer expires. On GPRS, this timer last between 5 and 8 seconds, but may effectively last between around 25 and 40 seconds, as the specifications state that the activation request should be re-sent up to five times.

Use RTelSubSessionBase::CancelAsyncRequest(EPacketRejectActivationRequest) to cancel a previously placed asynchronous RejectActivationRequest() request.

Sets when the attachment to the GPRS network should occur, in version 1 of the API.

In either mode, the manual Attach() and Detach() functions will force the attach or detach respectively, as long as it is a valid action.

The asynchronous version should be used from v7.0S.

This asynchronous method may be called by the client. It has superseded the synchronous variant of this method.

It sets when the 'attach' to the packet network should occur.

Sets the default context parameters in the phone, in version 1 of the API. The default context parameters are the parameters which the phone will use if no context parameters have been explicitly set up via either the ETel API or AT commands from an external PC.

The actual context parameters are set up in the RPacketContext::TContextConfigGPRS or RPacketContext::TContextConfigCDMA structure.

To determine how to correctly unpack the descriptor inside the TSY, the TSY must first cast the descriptor to a TPacketDataConfigBase pointer and check whether ExtensionId() returns KConfigGPRS, KConfigCDMA or KConfigRel99Rel4. The TSY will then cast the descriptor to the correct TPacketDataConfigBase-derived class.

The asynchronous version should be used from v7.0S.

This asynchronous method may be called by the client. It has superseded the synchronous variant of this method.

It will set the default context parameters in the ME. These are the parameters the ME will use if no explicit context parameters have previously been set up.

To determine how to correctly unpack the descriptor inside the TSY, the TSY must first cast The descriptor to a TPacketDataConfigBase pointer and check the iExtensionId. Depending on the iExtensionId, the TSY will then cast the descriptor to the correct TPacketDataConfigBase-derived class.

Sets the current packet class of the mobile station. This should never be higher than the maximum packet class of the mobile station.

It is expected that this function will be used to force a ClassSuspensionRequired mobile into a Class C mode of operation: either packet or circuit-switched only. This is useful, for instance, in a situation where the user is billed for incoming circuit-switched calls (a practice of U.S. network operators) and does not wish to be available for incoming calls for long periods of time, but does want to keep the packet side of the phone always on and always connected.

This is an asynchronous function.

Once the notification completes, the client must then re-post the notification if they wish to continue receiving further notifications.

Use RTelSubSessionBase::CancelAsyncRequest(EPacketSetMSClass) to cancel a previously placed asynchronous SetMSClass() request.

Sets the preferred bearer for the Mobile Terminal to use when as default when dropping from Class B operation to Class C. This could happen when the Mobile Terminal moves into a Routing Area of cells or new GPRS network which operates in Network Mode III. (Class C operation requires that the Mobile Terminal is attached to either GSM or GPRS, not both.)

Should the Mobile Terminal be a Class C only device, this function is used simply to switch bearers. If the required bearer is GSM, the Mobile Terminal will immediately attempt to attach to the GSM service. If GPRS, the Mobile Terminal may either immediately attempt to attach to the GPRS service or wait until context activation to attach, depending on the current attach mode as defined by TAttachMode.

This is an asynchronous function.

Use RTelSubSessionBase::CancelAsyncRequest(EPacketSetPrefBearer) to cancel a previously placed asynchronous SetPreferredBearer() request.

Updates the MBMS monitor service availability list with the entries as per the action mentioned in second parameter. The list, which is supplied by the client in an instance of CRetrievePcktMbmsServiceAvailability, should not contain more entries than can be stored. This method will store all the mbms service availability list entries in the CPcktMbmsMonitoredServiceList into the packet storage.

Defines when the attachment to the GPRS network should occur.

Modes: GPRS

Dynamic capabilities.

Modes: GPRS/CDMA

MS class configuration.

The preferred bearer.

Packet Network Registration/Availability.

Static capabilities.

Modes: GPRS

Defines the packet data connection status.

Typedef to hold the RPacketService::TDynamicCaps .