/*

 * 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