/*
* Copyright (c) 2007-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:
*
*/




#ifndef FEATMGR_H 
#define FEATMGR_H 

//  INCLUDES
#include <e32std.h>
#include <e32svr.h>

// FORWARD DECLARATIONS
class CFeatMgrTlsData;

// DEFINES

// CLASS DECLARATION

// CONSTANTS

/**
 Feature manager API.
 Feature manager API offers the following functionality:
 - Inquire whether a certain static feature is supported.
 For usage, see example code at the end of the header file.

@publishedPartner
@deprecated Use the class CFeatureDiscovery for basic feature queries, or the 
             class RFeatureControl for advanced feature queries and control.
*/
class FeatureManager
    {
    public: 

        /**
         This must be called in the scope of the thread before calling
         any other methods. It sets up TLS. Uninitialization is done
         by calling the UnInitializeLib() function.
        
         @leave KErrNoMemory Memory allocation failure. 
        
         @deprecated Use the class CFeatureDiscovery for basic feature queries, or the 
                     class RFeatureControl for advanced feature queries and control.
        */
        IMPORT_C static void InitializeLibL();

        /**
         This must be called in the scope of the thread after calling
         InitializeLibL(). It frees the allocated TLS. Do not call UnInitializeLib() 
         if InitalizeLibL() leaves.
        
         @deprecated Use the class CFeatureDiscovery for basic feature queries, or the 
                     class RFeatureControl for advanced feature queries and control.
        */
        IMPORT_C static void UnInitializeLib();
        
		/**
         Fetches information whether a certain feature is supported.
        
         @param aFeature feature id.
         @return feature support status.
        
         @deprecated Use the class CFeatureDiscovery for basic feature queries, or the 
                     class RFeatureControl for advanced feature queries and control.
        */		
        IMPORT_C static TBool FeatureSupported(TInt aFeature);

	private: 

        /**
         Get TlsData pointer.
        
         @return object stored in TLS
        */
        static CFeatMgrTlsData* TlsData();

    private:

        /**
         C++ default constructor.
         Prohibits instantiation of this class.
        */
        FeatureManager();
        
      
    };

/**
 Example usage:

 @code
 // replace <featureUID> with a real UID 

 #include <featmgr/featmgr.h>
 #include <bldvariant.hrh> // for feature definitions

 CMyClass::ConstructL()
     {
     // Sets up TLS, must be done before FeatureManager is used.
     FeatureManager::InitializeLibL();
     // Used in destructor. 
     iFeatMgrInitialized = ETrue;
     }

 CMyClass::ShowMenuL()
     {
     if ( FeatureManager::FeatureSupported( <featureUID> ) )
         {
         // Feature supported, show menu item associated with it.
         }
     }

 CMyClass::~CMyClass()
     {
     // Do not call UnInitializeLib() if InitalizeLib() leaves.
     if ( iFeatMgrInitialized )
         {
	      // Frees the TLS. Must be done after FeatureManager is used.
         FeatureManager::UnInitializeLib();  
         }
     }
 @endcode

*/
#endif      // FEATMGR_H 
            
// End of File