diff -r 000000000000 -r af10295192d8 linklayercontrol/networkinterfacemgr/inc/CAgentBase.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/linklayercontrol/networkinterfacemgr/inc/CAgentBase.h Tue Jan 26 15:23:49 2010 +0200 @@ -0,0 +1,113 @@ +// Copyright (c) 2003-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: +// Base classes for agents that require commdb access. +// This file contains the APIs required to implement an agent for Symbian OS that accesses commdb. +// +// + +/** + @file + @publishedPartner + @deprecated since v9.5. Use MCPRs/CPRs/SCPRs instead of agents. +*/ + +#if !defined(__CAGENTBASE_H__) +#define __CAGENTBASE_H__ + +#include +#include +#include +#include + +class CAgentDialogProcessor; + +/** + * Base class for agents that access commdb and use overrides + * + * @publishedPartner + * @deprecated since v9.5. Use MCPRs/CPRs/SCPRs instead of agents. + */ +class CAgentBase : public CNifAgentBase, public MServiceChangeObserver, public MDialogProcessorObserver, public MNetworkControllerObserver + { + friend class CAgentDialogProcessor; + +public: + IMPORT_C virtual ~CAgentBase(); +protected: + IMPORT_C void ConstructL(); + IMPORT_C CAgentBase(); +public: + + // implementation of the CNifAgentBase interface + IMPORT_C virtual void Reconnect(); + IMPORT_C virtual void CancelReconnect(); + IMPORT_C virtual void Authenticate(TDes& aUsername, TDes& aPassword); + IMPORT_C virtual void CancelAuthenticate(); + IMPORT_C virtual void RequestNotificationOfServiceChangeL(MAgentSessionNotify* aSession); + IMPORT_C virtual void CancelRequestNotificationOfServiceChange(MAgentSessionNotify* aSession); + IMPORT_C virtual void SetConnectionSettingsL(const TConnectionSettings& aSettings); + IMPORT_C virtual TConnectionSettings& ConnectionSettingsL(); + IMPORT_C virtual void SetOverridesL(CStoreableOverrideSettings* aOverrideSettings); + IMPORT_C virtual CStoreableOverrideSettings* OverridesL(); + IMPORT_C virtual TBool IsActive() const; + + // implementation of the MDialogProcessorObserver interface + IMPORT_C virtual void MDPOAuthenticateComplete(TInt aError); + + // implementation of the MServiceChangeObserver interface + IMPORT_C virtual void ServiceChangeNotification(TUint32 aId, const TDesC& aType); + + // implementation of the MNetworkControllerObserver interface + IMPORT_C virtual void SelectComplete(const TDesC& aName); + IMPORT_C virtual void SelectComplete(TInt aError); + IMPORT_C virtual void ReconnectComplete(TInt aError); + + +protected: + IMPORT_C virtual TInt DoReadInt(const TDesC& aField, TUint32& aValue,const RMessagePtr2* aMessage); + IMPORT_C virtual TInt DoWriteInt(const TDesC& aField, TUint32 aValue,const RMessagePtr2* aMessage); + IMPORT_C virtual TInt DoReadDes(const TDesC& aField, TDes8& aValue,const RMessagePtr2* aMessage); + IMPORT_C virtual TInt DoWriteDes(const TDesC& aField, const TDesC8& aValue,const RMessagePtr2* aMessage); + IMPORT_C virtual TInt DoReadDes(const TDesC& aField, TDes16& aValue,const RMessagePtr2* aMessage); + IMPORT_C virtual TInt DoWriteDes(const TDesC& aField, const TDesC16& aValue,const RMessagePtr2* aMessage); + IMPORT_C virtual TInt DoReadBool(const TDesC& aField, TBool& aValue,const RMessagePtr2* aMessage); + IMPORT_C virtual TInt DoWriteBool(const TDesC& aField, TBool aValue,const RMessagePtr2* aMessage); + IMPORT_C virtual HBufC* DoReadLongDesLC(const TDesC& aField,const RMessagePtr2* aMessage); + + IMPORT_C virtual TInt DoCheckReadCapability( const TDesC& aField, const RMessagePtr2* aMessage ); + IMPORT_C virtual TInt DoCheckWriteCapability( const TDesC& aField, const RMessagePtr2* aMessage ); + +#ifdef SYMBIAN_ADAPTIVE_TCP_RECEIVE_WINDOW +public: + IMPORT_C virtual TUint32 GetBearerInfo() const; +#endif //SYMBIAN_ADAPTIVE_TCP_RECEIVE_WINDOW + + + +private: + static TInt AuthenticateCb(TAny* aThisPtr); + inline CDialogProcessor* DialogProcessor() { return iDlgPrc; }; + +protected: + CCommsDbAccess* iDatabase; //< for commdb access + CDialogProcessor* iDlgPrc; //< pointer to the dialog processor for prompting the user + CStoreableOverrideSettings* iOverrides; //< application specified overrides for the settings in commdb (either these or TConnectionPreferences should be set, I think depending on which API the client is using (RConnection/RGenericAgent)??) + RPointerArray iServiceChangeNotification; //< pointers to CNifSessions for notification of service change + CAsyncCallBack* iAuthenticateCallback; //< [*** to do ***] + TInt iAuthenticateError; //< the error code, if any, generated during authentication + TConnectionSettings iSettings; //< the settings for this connection + }; + +#endif +