<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE concept

  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

<concept xml:lang="en" id="GUID-695B292F-114C-528F-9F71-1D03801D2203"><title>Network Dialog API</title><shortdesc>This topic describes the Agent Dialog Server component which includes the Network Dialog API. The connection agent dialog server allows the user to set up an Internet connection using the connection agent and its extensions. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody><p>The dialog server functionality is as follows: </p> <ul><li id="GUID-14A8D9F5-4410-5DBB-9498-42AA0D70578E"><p> <b>Connection dialog</b> - allows the user to select the service, modem, location and chargecard to be used at connection time. </p> </li> <li id="GUID-F7B272E5-24CE-596A-AC73-1CF3493700F7"><p> <b>Warn of a new connection dialog</b> - warns the user that a previous connection failed and a new connection is attempted. </p> </li> <li id="GUID-241FE1EA-BB78-50D8-B302-8466A0EB2858"><p> <b>Login and authentication dialogs</b> - allows the user to enter the username and password for script login and PPP authentication at connection time. </p> </li> <li id="GUID-E7E60609-2956-59EC-82DB-E1BBCAD77C81"><p> <b>Post connection terminal (PCT)</b> - allows the user to view the login script running, view what is sent and received and allows the user to type responses. </p> </li> <li id="GUID-065D45EF-EFA3-5C86-AAD6-BD9FE70298D3"><p> <b>Reconnection dialog</b> - informs the user of a lost connection and queries if they want to reconnect. </p> </li> <li id="GUID-BA6E3F04-2761-5B0F-926D-2190B4EE8ACC"><p> <b>QoS Warning dialog</b> – informs the user when the connection drops below the minimum acceptable quality and queries if they want to disconnect or not. </p> </li> </ul> <p>The Agent Dialog Server uses the client-server architecture. The client side of the server consists of the <xref href="GUID-23A5955F-0108-3965-B54C-3BEAF7687253.dita"><apiname>RGenConAgentDialogServer</apiname></xref> class, which provides access methods to operations provided by the server. The <xref href="GUID-541F0570-7FEA-3226-AF7E-D33FCC083742.dita"><apiname>CNetDialDialogServer</apiname></xref> class co-ordinates access to supported functionality, and creates server session objects, of type <xref href="GUID-D77A3050-6345-3280-9FB6-893963B9E37A.dita"><apiname>CNetDialDialogSession</apiname></xref>, when new connections to the server are made. </p> <p>The server is a Comms Provider Module (CPM) and is loaded through the Root Server API. It is loaded on demand, so a <filepath>.CMI</filepath> file does not exist for it. All requests for dialogs can be cancelled without waiting for user interaction, due to a timeout or a change in circumstances that required the dialog. </p> </conbody></concept>