omacpadapters/accesspointadapter/Inc/CWPAPItemBase.h
author hgs
Tue, 13 Jul 2010 04:01:20 +0530
changeset 47 d316aecb87fd
permissions -rw-r--r--
201025_02
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
47
d316aecb87fd 201025_02
hgs
parents:
diff changeset
     1
/*
d316aecb87fd 201025_02
hgs
parents:
diff changeset
     2
* Copyright (c) 2002 Nokia Corporation and/or its subsidiary(-ies). 
d316aecb87fd 201025_02
hgs
parents:
diff changeset
     3
* All rights reserved.
d316aecb87fd 201025_02
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
d316aecb87fd 201025_02
hgs
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
d316aecb87fd 201025_02
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
d316aecb87fd 201025_02
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
d316aecb87fd 201025_02
hgs
parents:
diff changeset
     8
*
d316aecb87fd 201025_02
hgs
parents:
diff changeset
     9
* Initial Contributors:
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    11
*
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    12
* Contributors:
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    13
*
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    14
* Description:     Defines a base class for all the items in WPAPAdapter
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    15
*
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    16
*/
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    17
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    18
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    19
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    20
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    21
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    22
#ifndef CWPAPITEMBASE_H
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    23
#define CWPAPITEMBASE_H
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    24
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    25
// INCLUDES
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    26
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    27
#include <e32base.h>
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    28
#include <cmconnectionmethodext.h>
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    29
#include <cmmanagerext.h>
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    30
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    31
// DATA TYPES
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    32
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    33
// Field types that can be marked received.
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    34
// Values defined to the power of to to enable masking.
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    35
enum TMarkedField
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    36
	{
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    37
	EWPParameterPxAddrType_id	= 2,
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    38
	EWPParameterPxAddrFQDN_id	= 4,
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    39
	EWPParameterNapID_id		= 8,
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    40
	EWPParameterService_id		= 16,
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    41
	EWPParameterPortNbr_id		= 32,
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    42
	EWPParameterPxAddr_id		= 64,
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    43
	EWPParameterAuthentication_id = 512,
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    44
    EWPParameterIfNetworks_id   = 1024,
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    45
    EWPParameterInternet_id     = 2048,
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    46
    EWPParameterWlan_id         = 4096
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    47
	};
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    48
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    49
// FORWARD DECLARATIONS
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    50
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    51
class CWPAPAccesspointItem;
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    52
class CCommsDatabase;
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    53
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    54
// CLASS DECLARATION
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    55
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    56
/**
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    57
 * CWPAPItemBase is a base class for all the items in WPAPAdapter.
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    58
 */ 
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    59
class CWPAPItemBase : public CBase
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    60
	{
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    61
	public:
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    62
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    63
        /**
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    64
        * Destructor.
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    65
        */
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    66
		~CWPAPItemBase();
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    67
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    68
	public: // New methods
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    69
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    70
		/**
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    71
		* Store the item data to APEngine's accesspoint item.
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    72
		* @param aAPItem item where data is stored.
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    73
		*/
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    74
		virtual void AddDataL( RCmConnectionMethodExt& ) = 0;
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    75
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    76
        /**
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    77
        * Add access point items to an array.
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    78
        * @param aItems The array to add to
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    79
        * @param aLogicalProxy The related logical proxy, if any
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    80
        * @param aPhysicalProxy The related physical proxy, if any
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    81
        */
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    82
        virtual TInt AddItemsL( RPointerArray<CWPAPAccesspointItem>& aItems,
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    83
            CWPAPItemBase* aLogicalProxy,
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    84
            CWPAPItemBase* aPhysicalProxy ) = 0;
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    85
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    86
        /**
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    87
        * The name of the item to be displayed to the user.
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    88
        * @return The name
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    89
        */
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    90
        virtual const TDesC& Name() = 0;
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    91
        
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    92
        /**
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    93
        * SaveWlanDataL
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    94
        */    
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    95
        virtual void SaveWlanDataL( TUint32 aIapId, CCommsDatabase& aCommsDb ) = 0;
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    96
    
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    97
        virtual void UpdateLingerL(const TUint32 aIapId) = 0;
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    98
d316aecb87fd 201025_02
hgs
parents:
diff changeset
    99
	protected: // New methods. Only for subclasses use.
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   100
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   101
        /**
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   102
        * Base constructor.
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   103
        * @param aDefaultName The default name to use for an access point
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   104
        */
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   105
        CWPAPItemBase( const TDesC& aDefaultName );
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   106
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   107
		/**
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   108
		* Mark that this field has arrived and was correctly handled.
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   109
		* @param aField received field enumeration
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   110
		*/
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   111
		void MarkReceived( TMarkedField aField );
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   112
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   113
		/**
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   114
		* Check has the given field been received.
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   115
		* @param aField received field enumeration
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   116
		* @return ETrue if the field has already been received and handled
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   117
		*/
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   118
		TBool IsReceived( TMarkedField aField );
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   119
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   120
	protected:
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   121
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   122
        /// The default name for an access point
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   123
        const TDesC& iDefaultName;
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   124
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   125
	private: // Data
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   126
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   127
		/// Received fields marked here.
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   128
		TUint32 iReceivedFieldsFlags;
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   129
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   130
	private: // For testing.
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   131
		friend class T_CWPAPItemBase;
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   132
	};
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   133
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   134
#endif	// CWPAPITEMBASE_H
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   135
            
d316aecb87fd 201025_02
hgs
parents:
diff changeset
   136
// End of File