|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-34BEF44B-EFBE-41EB-941D-0410FCB6782E" xml:lang="en"><title>Extended |
|
13 Connection Preferences</title><shortdesc>The Extended Connection Preferences API provides customized control |
|
14 over the connection establishment process followed by the applications.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
15 <section> <title>Purpose</title> <p> The Extended Connection Preferences |
|
16 API is used to control and customize the connection establishment behavior |
|
17 of applications. The API handles applications with special needs in connectivity |
|
18 accordingly. For example, connection to a specific SNAP or connection |
|
19 to a specific IAP so on. Many applications do not need a customized connection |
|
20 establishment process and hence, usage of this API is not needed by majority |
|
21 of applications.</p> </section> |
|
22 <section><title>Required Background</title><p>The extended connection preferences |
|
23 are passed to <xref href="GUID-BED8A733-2ED7-31AD-A911-C1F4707C67FD.dita#GUID-BED8A733-2ED7-31AD-A911-C1F4707C67FD/GUID-21FFAEE0-EEE9-3DEC-8C74-724906DC55D6"><apiname>RConnection::Start() function </apiname></xref> as part of <xref href="GUID-F306C194-1B5E-35E2-AA36-E1AD797CC26F.dita"><apiname>TConnPrefList</apiname></xref> object. </p><p>The |
|
24 user of the API should link against extendedconnpref.lib and netmeta.lib |
|
25 and include the header file, <filepath>extendedconnpref.h.</filepath> </p></section> |
|
26 <section><title>API Summary</title><p> The API defines extended connection |
|
27 preferences as a set of parameters. The class that handles the preference |
|
28 parameters is described below:</p><table id="GUID-6858178D-3090-4451-A8E5-828F0763A920"> |
|
29 <tgroup cols="2"><colspec colname="col1"/><colspec colname="col2"/> |
|
30 <tbody> |
|
31 <row> |
|
32 <entry>Class Name</entry> |
|
33 <entry>Description</entry> |
|
34 </row> |
|
35 <row> |
|
36 <entry> <xref href="GUID-B78E8AC0-CDC8-3DEC-AF3C-98C8994DA34A.dita"><apiname>TExtendedConnPref</apiname></xref></entry> |
|
37 <entry><p>Is derived from <xref href="GUID-3C859C5B-951E-3CE7-95F9-C2F246FC6DC3.dita"><apiname>SMetaDataECom</apiname></xref> and defines the |
|
38 functions that set the preferences for a customized connection.</p></entry> |
|
39 </row> |
|
40 </tbody> |
|
41 </tgroup> |
|
42 </table></section> |
|
43 <section><title>Architectural Relationships</title><fig id="GUID-D55FA7FA-A914-483B-80E4-FCA159B24648"> |
|
44 <title>Class Relationships for TExtendedConnPref</title> |
|
45 <image href="GUID-21F0EE0E-6CC6-44E7-9FED-FB8911E3C3A2_d0e211670_href.jpg" placement="inline"/> |
|
46 </fig></section> |
|
47 <section><title>Typical Uses</title><p> The API provides the following key |
|
48 services: </p><ul> |
|
49 <li><p>Open a connection to a specific Service Network Access Point (SNAP) |
|
50 (By specifying Type)</p></li> |
|
51 <li><p>Open a connection to a specific SNAP (By specifying the SNAP ID)</p></li> |
|
52 <li><p>Open a connection to a specific Internet Access Point (IAP) </p></li> |
|
53 <li><p>Open a connection by querying the connection method from the user</p></li> |
|
54 <li><p>Open a connection without the discreet pop-ups</p></li> |
|
55 <li><p>Open a connection without any queries </p></li> |
|
56 <li><p>Disallow automatic switch to Wireless Local Area Network (WLAN) </p></li> |
|
57 <li><p>Bearer filtering </p></li> |
|
58 <li><p>Inform middleware that application handles contention </p></li> |
|
59 </ul></section> |
|
60 <section><title>See also</title> </section> |
|
61 </conbody></concept> |