Symbian3/PDK/Source/GUID-A7F7912B-2E82-5F4F-B4F0-5EE97D884960.dita
author Dominic Pinkman <Dominic.Pinkman@Nokia.com>
Thu, 11 Mar 2010 18:02:22 +0000
changeset 3 46218c8b8afa
parent 1 25a17d01db0c
child 5 f345bda72bc4
permissions -rw-r--r--
week 10 bug fix submission (SF PDK version): Bug 1892, Bug 1897, Bug 1319. Also 3 or 4 documents were found to contain code blocks with SFL, which has been fixed. Partial fix for broken links, links to Forum Nokia, and the 'Symbian platform' terminology issues.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
3
46218c8b8afa week 10 bug fix submission (SF PDK version): Bug 1892, Bug 1897, Bug 1319. Also 3 or 4 documents were found to contain code blocks with SFL, which has been fixed. Partial fix for broken links, links to Forum Nokia, and the 'Symbian platform' terminology issues.
Dominic Pinkman <Dominic.Pinkman@Nokia.com>
parents: 1
diff changeset
     1
<?xml version="1.0" encoding="utf-8"?>
46218c8b8afa week 10 bug fix submission (SF PDK version): Bug 1892, Bug 1897, Bug 1319. Also 3 or 4 documents were found to contain code blocks with SFL, which has been fixed. Partial fix for broken links, links to Forum Nokia, and the 'Symbian platform' terminology issues.
Dominic Pinkman <Dominic.Pinkman@Nokia.com>
parents: 1
diff changeset
     2
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
46218c8b8afa week 10 bug fix submission (SF PDK version): Bug 1892, Bug 1897, Bug 1319. Also 3 or 4 documents were found to contain code blocks with SFL, which has been fixed. Partial fix for broken links, links to Forum Nokia, and the 'Symbian platform' terminology issues.
Dominic Pinkman <Dominic.Pinkman@Nokia.com>
parents: 1
diff changeset
     3
<!-- This component and the accompanying materials are made available under the terms of the License 
46218c8b8afa week 10 bug fix submission (SF PDK version): Bug 1892, Bug 1897, Bug 1319. Also 3 or 4 documents were found to contain code blocks with SFL, which has been fixed. Partial fix for broken links, links to Forum Nokia, and the 'Symbian platform' terminology issues.
Dominic Pinkman <Dominic.Pinkman@Nokia.com>
parents: 1
diff changeset
     4
"Eclipse Public License v1.0" which accompanies this distribution, 
46218c8b8afa week 10 bug fix submission (SF PDK version): Bug 1892, Bug 1897, Bug 1319. Also 3 or 4 documents were found to contain code blocks with SFL, which has been fixed. Partial fix for broken links, links to Forum Nokia, and the 'Symbian platform' terminology issues.
Dominic Pinkman <Dominic.Pinkman@Nokia.com>
parents: 1
diff changeset
     5
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
46218c8b8afa week 10 bug fix submission (SF PDK version): Bug 1892, Bug 1897, Bug 1319. Also 3 or 4 documents were found to contain code blocks with SFL, which has been fixed. Partial fix for broken links, links to Forum Nokia, and the 'Symbian platform' terminology issues.
Dominic Pinkman <Dominic.Pinkman@Nokia.com>
parents: 1
diff changeset
     6
<!-- Initial Contributors:
46218c8b8afa week 10 bug fix submission (SF PDK version): Bug 1892, Bug 1897, Bug 1319. Also 3 or 4 documents were found to contain code blocks with SFL, which has been fixed. Partial fix for broken links, links to Forum Nokia, and the 'Symbian platform' terminology issues.
Dominic Pinkman <Dominic.Pinkman@Nokia.com>
parents: 1
diff changeset
     7
    Nokia Corporation - initial contribution.
46218c8b8afa week 10 bug fix submission (SF PDK version): Bug 1892, Bug 1897, Bug 1319. Also 3 or 4 documents were found to contain code blocks with SFL, which has been fixed. Partial fix for broken links, links to Forum Nokia, and the 'Symbian platform' terminology issues.
Dominic Pinkman <Dominic.Pinkman@Nokia.com>
parents: 1
diff changeset
     8
Contributors: 
46218c8b8afa week 10 bug fix submission (SF PDK version): Bug 1892, Bug 1897, Bug 1319. Also 3 or 4 documents were found to contain code blocks with SFL, which has been fixed. Partial fix for broken links, links to Forum Nokia, and the 'Symbian platform' terminology issues.
Dominic Pinkman <Dominic.Pinkman@Nokia.com>
parents: 1
diff changeset
     9
-->
46218c8b8afa week 10 bug fix submission (SF PDK version): Bug 1892, Bug 1897, Bug 1319. Also 3 or 4 documents were found to contain code blocks with SFL, which has been fixed. Partial fix for broken links, links to Forum Nokia, and the 'Symbian platform' terminology issues.
Dominic Pinkman <Dominic.Pinkman@Nokia.com>
parents: 1
diff changeset
    10
<!DOCTYPE task
46218c8b8afa week 10 bug fix submission (SF PDK version): Bug 1892, Bug 1897, Bug 1319. Also 3 or 4 documents were found to contain code blocks with SFL, which has been fixed. Partial fix for broken links, links to Forum Nokia, and the 'Symbian platform' terminology issues.
Dominic Pinkman <Dominic.Pinkman@Nokia.com>
parents: 1
diff changeset
    11
  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
1
25a17d01db0c Addition of the PDK content and example code for Documentation_content according to Feature bug 1607 and bug 1608
Dominic Pinkman <Dominic.Pinkman@Nokia.com>
parents:
diff changeset
    12
<task xml:lang="en" id="GUID-A7F7912B-2E82-5F4F-B4F0-5EE97D884960"><title>Packet Context Tutorial </title><shortdesc>This tutorial describes how to define a context for the packet service sub-session. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody> <steps id="GUID-337E9E55-3D59-5EB4-A569-2456E97AC60B"> <step id="GUID-E8B21200-E078-53A3-AE5E-994AE8AF2A49"><cmd/><info>To create a context do one of the following: </info> <substeps id="GUID-3D25C15D-1F30-520A-8692-98A5C1BC75F6"><substep id="GUID-1F19E2CE-4FD6-57A2-8DAF-C94B9F8239F6"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::OpenNewContext()</apiname></xref> to open a new context. </info> </substep> <substep id="GUID-914AE066-30AF-5508-8A30-E899274A59B5"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::OpenExistingContext()</apiname></xref> to open an existing context. </info> </substep> </substeps> </step> <step id="GUID-401668B9-E59E-53C1-8869-07CF16F8E65A"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::SetConfig()</apiname></xref> to set the parameters for a context. </info> <info>The context parameters are defined in : </info> <substeps id="GUID-44055DA6-6106-5F88-9E4E-004DDEFE1967"><substep id="GUID-FC4DE6E1-2A35-535F-8830-E4E5B01DDF43"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname> TContextConfigR99_R4</apiname></xref>  </info> </substep> <substep id="GUID-553A34A2-3887-5B3D-960A-54383901314F"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname> TContextConfig_R5 </apiname></xref>  </info> </substep> <substep id="GUID-6A936E02-F9D4-5E2F-989F-CEEC62710024"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname> TContextConfigGPRS </apiname></xref>  </info> </substep> <substep id="GUID-286E3550-D0F6-52C0-9B19-3C133E7999E5"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname> TContextConfigCDMA </apiname></xref>  </info> </substep> <substep id="GUID-60B6835D-BDE3-5909-A892-8C08907D7746"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>TProtocolType </apiname></xref>  </info> </substep> <substep id="GUID-572D2B80-1865-552C-8FB8-EE0949DC7EC3"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>TGSNAddress </apiname></xref>  </info> </substep> <substep id="GUID-3AE25471-96D3-5C05-A909-8528199A6CBB"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>TProtocolAddress </apiname></xref>  </info> </substep> <substep id="GUID-6CD12278-2FCE-571D-ADE9-8121A8816B59"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>TProtocolConfigBufferV2</apiname></xref>  </info> </substep> <substep id="GUID-B284B3AF-FBC6-5803-8DC1-657EF7998D3B"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>TMiscProtocolBuffer</apiname></xref>  </info> </substep> <substep id="GUID-82531441-0548-5A7F-84F6-CD84049A092B"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>TDnsInfoV2</apiname></xref>  </info> </substep> <substep id="GUID-975E2C17-BFCA-51A2-94D3-0FC6965DA807"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>TAnonymousAccess</apiname></xref>  </info> </substep> <substep id="GUID-4550C342-1824-5E51-B1AC-5B2E11B96B7B"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>TPacketFlowIndicator</apiname></xref>  </info> </substep> </substeps> <info>The MBMS parameters are defined in: </info> <substeps id="GUID-4217B963-1A8A-5F3C-974A-2725FD9A71E9"><substep id="GUID-B635B5C2-4743-5F94-A89F-D94D3C2B4FF5"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketMbmsContext::TContextConfigMbmsV1()</apiname></xref> </info> </substep> <substep id="GUID-DF75FF63-039C-5AA1-A4C2-78F6CB02747C"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>TMbmsServicePriority</apiname></xref>  </info> </substep> </substeps> </step> <step id="GUID-DAA6F9AF-A76B-5C9A-A39F-9771FDD80486"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::GetConfig()</apiname></xref> to retrieve the information about a context. </info> </step> <step id="GUID-255ECCFF-C618-505E-B30A-F6BDA8415200"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::NotifyConfigChanged()</apiname></xref> to get the notification of any changes to the current context parameters. </info> </step> <step id="GUID-08E08678-6942-55F2-AFDD-D1889C405DA5"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::Activate()</apiname></xref> to activate a context </info> </step> <step id="GUID-81076BC7-A225-58F8-8619-644E75F5D8FA"><cmd/><info>Initialise the context with <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::InitialiseContext()</apiname></xref>. </info> </step> <step id="GUID-679709BC-2ED2-5438-B689-1AB38185DC4E"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::Deactivate()</apiname></xref> to deactivate a context. </info> </step> <step id="GUID-87018D99-C775-5088-9139-EA5610DCB001"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::Delete()</apiname></xref> to delete a context. </info> </step> <step id="GUID-076FFE9C-3531-5AEA-9F2A-616774947B58"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::GetStatus()</apiname></xref> to retrieve the status of the current contexts. </info> <info>The context statuses of a context are defined in <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>TContextStatus</apiname></xref> enumeration. </info> </step> <step id="GUID-7B9232BB-A7A1-5437-8EEF-F99DBE1B35BB"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::NotifyStatusChange()</apiname></xref> to get the notification of any changes to the status of a context. </info> </step> <step id="GUID-72B0CB6E-9D32-56D7-8962-02A73A6D688E"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::GetProfileName()</apiname></xref> to retrieve the quality of service profile used by a context. </info> </step> <step id="GUID-9BFD3D51-C298-57B1-BC86-186CC3DA7F62"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::GetDataVolumeTransferred()</apiname></xref> to retrieve the information related to the data sent in the packet service using a context. </info> </step> <step id="GUID-71A0943C-653A-5260-BB6F-4425BF699EDD"><cmd/><info>Use<xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname> RPacketContext::NotifyDataTransferred()</apiname></xref> to receive the notification about the change in the amount of data transferred. </info> </step> <step id="GUID-67E14757-4770-52C6-978B-038992904E13"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::NotifyConnectionSpeedChange()</apiname></xref> to retrieve the information about the connection speed of a packet service sub-session. </info> </step> <step id="GUID-CD5CC472-A521-54D5-BA41-35427C43EB78"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::GetLastErrorCause()</apiname></xref> to retrieve the last error that occurred on a packet service sub-session. </info> </step> <step id="GUID-8E4D3AD9-FE00-53FD-93F6-E82EC0559B21"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::ModifyActiveContext()</apiname></xref> to change the active context. </info> </step> <step id="GUID-CD166619-036B-5AAF-A155-77F2EF45A6DE"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RTelSubSessionBase::CancelAsyncRequest()</apiname></xref> to cancel any of the above commands. </info> </step> <step id="GUID-9E8BED78-8CF2-5BAF-89CB-301E01673AE7"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::Close()</apiname></xref> to close the handle to a context. </info> </step> </steps> </taskbody><related-links><link href="GUID-76D2CDCA-DD7C-56D4-A913-6A959686B8D5.dita"><linktext>MBMS Context Tutorial</linktext> </link> </related-links></task>