diff -r 000000000000 -r af10295192d8 linklayercontrol/networkinterfacemgr/inc/dialogprocessor.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/linklayercontrol/networkinterfacemgr/inc/dialogprocessor.h Tue Jan 26 15:23:49 2010 +0200 @@ -0,0 +1,144 @@ +/** +* Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of "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: +* +* Description: +* +*/ + + + +/** + @file DialogProcessor.H + @internalTechnology +*/ + +#ifndef __ND_DLGPC_H__ +#define __ND_DLGPC_H__ + +#include +#include + +class CDialogDestroyPCTNotification; + +class MDialogProcessorObserver +/** +MDialogProcessorObserver + +Mixin observer class to be derived from by classes wishing to use CDialogProcessor. +When the relevant asynchronous function call completes the appropriate function will +be called on the observer. Only completion functions used need to be implemented. +@internalTechnology +*/ + { +public: + IMPORT_C virtual void MDPOSelectComplete(TInt aError, const TConnectionSettings& aSettings); + IMPORT_C virtual void MDPOSelectModemAndLocationComplete(TInt aError, const TConnectionSettings& aSettings); + IMPORT_C virtual void MDPOWarnComplete(TInt aError, TBool aResponse); + IMPORT_C virtual void MDPOLoginComplete(TInt aError); + IMPORT_C virtual void MDPOAuthenticateComplete(TInt aError); + IMPORT_C virtual void MDPOReconnectComplete(TInt aError); + IMPORT_C virtual void MDPOReadPctComplete(TInt aError); + IMPORT_C virtual void MDPODestroyPctComplete(TInt aError); + IMPORT_C virtual void MDPOQoSWarningComplete(TInt aError, TBool aResponse); + }; + +/** +CDialogDestroyPCTNotification + +Interface between CDialogProcessor and dialog server for destroy PCT notification only. +This needs to be a sepearate class to CDailogProcesor because it will be active +the whole time the PCT is open. One per CDialogProcessor object and it uses the +CScriptEngD object to return destroy PCt notification to the scrpt engine. Has an +RGenConAgentDialogServer - class with fixed API to be implemented by dialog server. + +This class is private to CDialogProcessor implementation and so its definition +has been moved to dialogprocessor.cpp +*/ +class CDialogDestroyPCTNotification; + +class CDialogProcessor : public CActive +/** +CDialogProcessor + +Interface between the agent and the dialog server. One per CAgentController object and it itself +uses the CAgentController object to return results of dialogs to state machine. Also uses a +CScriptEngD to return results of PCT read to the script engine. Has a +CDialogDestroyPCTNotification to request that a notification is sent when the PCT is +destroyed. Has an RGenConAgentDialogServer - class with fixed API to be implemented by +dialog server. +@internalTechnology +*/ + { + friend class CDialogDestroyPCTNotification; +public: + IMPORT_C static CDialogProcessor* NewL(TInt aPriority = CActive::EPriorityStandard); + IMPORT_C ~CDialogProcessor(); + + /** Call from the agent controller (which require a response) */ + IMPORT_C void SelectConnection(MDialogProcessorObserver& aObserver, const TConnectionPrefs& aPrefs); + IMPORT_C void SelectConnection(MDialogProcessorObserver& aObserver, const TConnectionPrefs& aPrefs, TInt aLastError); + IMPORT_C void SelectModemAndLocation(MDialogProcessorObserver& aObserver); + IMPORT_C void Authenticate(MDialogProcessorObserver& aObserver, TDes& aUsername, TDes& aPassword, TBool aIsReconnect); + IMPORT_C void Reconnect(MDialogProcessorObserver& aObserver); + + /** Call from the states (which require a response) */ + IMPORT_C void WarnNewConnection(MDialogProcessorObserver& aObserver, const TConnectionPrefs& aPrefs, const TDesC* aNewIapName, const TIspConnectionNames* aNewConnectionNames, TInt aLastError); + IMPORT_C void Login(MDialogProcessorObserver& aObserver, TDes& aUsername, TDes& aPassword, TBool aIsReconnect); + IMPORT_C void DestroyPctNotification(MDialogProcessorObserver& aObserver); + IMPORT_C void ReadPct(MDialogProcessorObserver& aObserver, TDes& aData); + IMPORT_C void QoSWarning(MDialogProcessorObserver& aObserver); +// +// Calls from the states (which do not require a response) +// + IMPORT_C TInt OpenPct(); + IMPORT_C TInt WritePct(const TDesC& aData); + IMPORT_C void ClosePct(); + + /** Should always call this rather than Cancel() if using PCT */ + IMPORT_C void CancelEverything(); +private: + enum TDPState + { + ENoState =0, + ESelectConnection, + EWarnNewConnection, + ESelectModemAndLocation, + ELogin, + EAuthentication, + EReconnect, + EReadPct, + EQoSWarning + }; +private: + CDialogProcessor(TInt aPriority); + void ConstructL(); + void CompleteDestroyPctNotification(TInt aStatus); + void SetActive(MDialogProcessorObserver& aObserver, TDPState aState); + + /** From CActive */ + virtual void DoCancel(); + virtual void RunL(); +private: + MDialogProcessorObserver* iCurrentObserver; + MDialogProcessorObserver* iPctDestructionObserver; + CDialogDestroyPCTNotification* iDestroyPctNotification; + RGenConAgentDialogServer iDlgServ; + TDPState iState; + TConnectionSettings iSettings; + TBool iReconResponse; + TBool iWarnNewConnectResponse; + TBool iQoSWarningResponse; + }; + +#endif +