1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/epoc32/include/connectprog.h Tue Mar 16 16:12:26 2010 +0000
1.3 @@ -0,0 +1,126 @@
1.4 +/**
1.5 +* Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
1.6 +* All rights reserved.
1.7 +* This component and the accompanying materials are made available
1.8 +* under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
1.9 +* which accompanies this distribution, and is available
1.10 +* at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
1.11 +*
1.12 +* Initial Contributors:
1.13 +* Nokia Corporation - initial contribution.
1.14 +*
1.15 +* Contributors:
1.16 +*
1.17 +* Description:
1.18 +*
1.19 +*/
1.20 +
1.21 +
1.22 +
1.23 +
1.24 +
1.25 +/**
1.26 + @file CONNECTPROG.H
1.27 +*/
1.28 +
1.29 +#ifndef __CONNECTPROG_H__
1.30 +#define __CONNECTPROG_H__
1.31 +
1.32 +#include <csdprog.h>
1.33 +
1.34 +// Stages in establishing a connection with NetDial
1.35 +
1.36 + /**
1.37 + * Defines the stages in establishing a connection with dial-up networking.
1.38 + *
1.39 + * The stages which may be reported depend on the type of connection being made.
1.40 + * Stage information is usually read from a TNifProgress::iStage member.
1.41 + *
1.42 + * @publishedAll
1.43 + * @since v5.0
1.44 + * @deprecated 7.0s - maintained for compatibility with 6.1\n
1.45 + * This enumeration is still used by the new RGenericAgent API.\n\n
1.46 + * New software should use the CSD progress values defined in csdprog.h
1.47 + *
1.48 + * \n
1.49 + * For a \b Dial \b Up \b Connection (outgoing call), the following stages are reported
1.50 + * in this order \n
1.51 + * (the meaning of each enumerator is defined in the enumeration values / member list, below):
1.52 + * -# EStartingSelection
1.53 + * -# EFinishedSelection
1.54 + * -# EStartingDialling
1.55 + * -# EFinishedDialling
1.56 + * -# EScanningScript
1.57 + * -# EScannedScript
1.58 + * -# EGettingLoginInfo
1.59 + * -# EGotLoginInfo
1.60 + * -# EStartingLogIn
1.61 + * -# EFinishedLogIn
1.62 + * -# EConnectionOpen
1.63 + * -# EStartingHangUp
1.64 + * -# EFinishedHangUp
1.65 + *
1.66 + * For a \b Dial \b In \b Connection (incoming call), the following stages are
1.67 + * reported in this order:
1.68 + * -# EStartingAnswer
1.69 + * -# EAnswered
1.70 + * -# EConnectionOpen
1.71 + * -# EStartingHangUp
1.72 + * -# EFinishedHangUp
1.73 + *
1.74 + * For a \b Direct \b Connection, the following stages are reported in this order:
1.75 + * -# EStartingSelection
1.76 + * -# EFinishedSelection
1.77 + * -# EScanningScript
1.78 + * -# EScannedScript
1.79 + * -# EStartingConnect
1.80 + * -# EFinishedConnect
1.81 + * -# EConnectionOpen
1.82 + * -# EStartingHangUp
1.83 + * -# EFinishedHangUp
1.84 + */
1.85 +
1.86 +enum TNetDialProgress
1.87 + {
1.88 + /** Start selection of service and location. */
1.89 + EStartingSelection=2,
1.90 + /** Selection of service and location is complete. */
1.91 + EFinishedSelection,
1.92 + /** Starting the dialling phase. */
1.93 + EStartingDialling,
1.94 + /** Dialling phase complete. */
1.95 + EFinishedDialling,
1.96 + /** Start scanning the script. */
1.97 + EScanningScript,
1.98 + /** Scanning the script is complete. */
1.99 + EScannedScript,
1.100 + /** Get login information from database or user */
1.101 + EGettingLoginInfo,
1.102 + /** The fetching of login information is complete. */
1.103 + EGotLoginInfo,
1.104 + /** Start the connection process; executes the script, if there is one */
1.105 + EStartingConnect, // 10
1.106 + /** Connection process is complete */
1.107 + EFinishedConnect,
1.108 + /** Start the login process; executes the script, if there is one. */
1.109 + EStartingLogIn,
1.110 + /** Login process is complete */
1.111 + EFinishedLogIn,
1.112 + /** The connection is now open */
1.113 + EConnectionOpen,
1.114 + /** Starting the hang-up process */
1.115 + EStartingHangUp,
1.116 + /** Hang up process is complete */
1.117 + EFinishedHangUp,
1.118 + /** Start the answering phase. */
1.119 + EStartingAnswer,
1.120 + /** Answering is complete */
1.121 + EAnswered, // 18
1.122 + /** Error setting overrides (note that this is reported only if an
1.123 + * error occurs, in which case it will be the first stage of the connection). */
1.124 + ESettingOverrides
1.125 + };
1.126 +
1.127 +
1.128 +
1.129 +#endif