sl@0: // Copyright (c) 2007-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0: // All rights reserved.
sl@0: // This component and the accompanying materials are made available
sl@0: // under the terms of "Eclipse Public License v1.0"
sl@0: // which accompanies this distribution, and is available
sl@0: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: //
sl@0: // Initial Contributors:
sl@0: // Nokia Corporation - initial contribution.
sl@0: //
sl@0: // Contributors:
sl@0: //
sl@0: // Description:
sl@0: // Implementation of wrapper API for querying support for features on a device, It 
sl@0: // internally uses Feature Manager query APIs.
sl@0: // 
sl@0: //
sl@0: 
sl@0: #include <e32uid.h>
sl@0: #include <featdiscovery.h>  
sl@0: #include "featregpan.h"
sl@0: #include "featreg.h"
sl@0: #include "featregcmn.h"
sl@0: 
sl@0: // Class to hold pointers to Cleanup stack & Feature Manager CFeatureDiscovery
sl@0: // virtual methods from CBase that result in these _TZ entries being generated.
sl@0: //NONSHARABLE_CLASS is used to remove _ZTI & _ZTV entry from def file . 
sl@0: NONSHARABLE_CLASS (CImplFeatDisc ) : public CBase
sl@0: 	{
sl@0: 	public:
sl@0: 		static CImplFeatDisc* NewL();
sl@0: 		~CImplFeatDisc();
sl@0: 	private:
sl@0: 		CImplFeatDisc();
sl@0: 		void ConstructL();
sl@0: 	
sl@0: 	public:
sl@0: 	
sl@0: 	CFeatureDiscovery *iFeatDis;
sl@0: 	CTrapCleanup * iCleanup;
sl@0: 	};
sl@0: 	
sl@0: 
sl@0: CImplFeatDisc::CImplFeatDisc() :   
sl@0: 	iFeatDis( NULL ), 
sl@0: 	iCleanup(NULL)
sl@0: 	{
sl@0: 		
sl@0: 	}
sl@0: 	
sl@0: CImplFeatDisc::~CImplFeatDisc()
sl@0: 	{
sl@0: 	delete iFeatDis;
sl@0: 	iFeatDis = 0;
sl@0: 	
sl@0: 	delete iCleanup;
sl@0: 	iCleanup = 0;
sl@0: 	}
sl@0: 
sl@0: void CImplFeatDisc::ConstructL()
sl@0:     {
sl@0:     iFeatDis = CFeatureDiscovery::NewL();
sl@0:     }
sl@0: 	
sl@0: 
sl@0: CImplFeatDisc* CImplFeatDisc::NewL()
sl@0:     {
sl@0:     CImplFeatDisc* self = new( ELeave ) CImplFeatDisc();
sl@0:     CleanupStack::PushL( self );
sl@0:     self->ConstructL();
sl@0:     CleanupStack::Pop( self );
sl@0: 
sl@0:     return self;
sl@0:     }
sl@0: 
sl@0: 
sl@0: /**
sl@0:  * Dummy feature registry implementation object - never instantiated.
sl@0:  * @internalComponent
sl@0:  */
sl@0: class RFeatureRegistry::TImpl
sl@0: 	{
sl@0: 	TUint32 iDummy;
sl@0: 	};
sl@0: 
sl@0: /**
sl@0:  * Opens connection to the Feature Registry for making non-static queries.
sl@0:  * Note all non-static queries return state at the time Open() was called;
sl@0:  * Feature Registry changes are not observed until instance closed and re-opened.
sl@0:  *
sl@0:  * @return KErrNone if successful, negative system-wide error code if fails
sl@0:  * @publishedPartner
sl@0:  * @deprecated
sl@0:  */
sl@0: EXPORT_C TInt RFeatureRegistry::Open()
sl@0: 	{
sl@0: 	__ASSERT_ALWAYS(iImpl == NULL, Panic(EFeatRegInvalidUse));
sl@0: 	
sl@0: 	CTrapCleanup *cleanup = NULL;
sl@0: 	
sl@0: 	if(User::TrapHandler() == NULL)
sl@0: 		{
sl@0: 		cleanup = CTrapCleanup::New();	
sl@0: 		if(cleanup == NULL)
sl@0: 	        {
sl@0: 	        return KErrNoMemory;
sl@0: 	        }
sl@0: 		}
sl@0: 	
sl@0: 	CImplFeatDisc  *ptrh = NULL; 	
sl@0: 	TRAPD( err,  ptrh = CImplFeatDisc::NewL() );
sl@0:     if ( err == KErrNone )
sl@0:         {
sl@0:     	ptrh->iCleanup = cleanup;
sl@0:         iImpl = reinterpret_cast<TImpl*> (ptrh);
sl@0:         }
sl@0:     else
sl@0:     	delete cleanup;
sl@0: 	return err;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0:  * Queries support for feature on the device.
sl@0:  * Non-static version requiring open instance of class.
sl@0:  * Recommended when making multiple queries.
sl@0:  * Note: returns support for feature from the time Open() was called.
sl@0:  *
sl@0:  * @param aFeatureUid Unique identifier of feature being queried
sl@0:  * @return positive value if feature is supported, zero if feature is not supported,
sl@0:  *     or negative system-wide error code if could not be determined.
sl@0:  * @pre this registry instance is open
sl@0:  * @panic FeatReg EFeatRegInvalidUse if this registry instance is not open
sl@0:  * @publishedPartner
sl@0:  * @deprecated
sl@0:  */
sl@0: EXPORT_C TInt RFeatureRegistry::QuerySupport(TUid aFeatureUid)
sl@0: 	{
sl@0: 	
sl@0: 	TUint32 dummyInfo;
sl@0: 	return QuerySupport(aFeatureUid, dummyInfo);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0:  * Queries support for feature on the device.
sl@0:  * Non-static version requiring open instance of class.
sl@0:  * Recommended when making multiple queries.
sl@0:  * Note: returns support for feature from the time Open() was called.
sl@0:  *
sl@0:  * @param aFeatureUid Unique identifier of feature being queried
sl@0:  * @param aInfo addition status information about feature
sl@0:  * @return positive value if feature is supported, zero if feature is not supported,
sl@0:  *     or negative system-wide error code if could not be determined.
sl@0:  * @pre this registry instance is open
sl@0:  * @panic FeatReg EFeatRegInvalidUse if this registry instance is not open
sl@0:  * @publishedPartner
sl@0:  * @deprecated
sl@0:  */
sl@0: EXPORT_C TInt RFeatureRegistry::QuerySupport(TUid aFeatureUid, TUint32& aInfo)
sl@0: 	{
sl@0: 	__ASSERT_ALWAYS(iImpl != NULL, Panic(EFeatRegInvalidUse));
sl@0: 
sl@0: 	CImplFeatDisc *ptrh  = reinterpret_cast<CImplFeatDisc*> (iImpl);
sl@0: 	
sl@0: 	if(ptrh->iFeatDis->IsSupported(aFeatureUid))
sl@0: 		{
sl@0: 		
sl@0: 		//FeatReg support only ROM features so EStatusUpgradableBit has no meaning
sl@0: 		//So aInfo always set to EStatusSupportBit in this wrapper
sl@0: 		aInfo = EStatusSupportBit;
sl@0: 		return EStatusSupportBit;		
sl@0: 		}
sl@0: 
sl@0: 	// feature not supported
sl@0: 	aInfo =0;
sl@0: 	return 0;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0:  * Closes this registry instance.
sl@0:  * @publishedPartner
sl@0:  * @deprecated
sl@0:  */
sl@0: EXPORT_C void RFeatureRegistry::Close()
sl@0: 	{
sl@0: 	CImplFeatDisc *ptrh  = reinterpret_cast<CImplFeatDisc*> (iImpl);
sl@0: 	delete ptrh;
sl@0: 	ptrh = 0;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0:  * Queries support for feature on the device.
sl@0:  * Static version recommended for single queries.
sl@0:  *
sl@0:  * @param aFeatureUid Unique identifier of feature being queried
sl@0:  * @return positive value if feature is supported, zero if feature is not supported,
sl@0:  *     or negative system-wide error code if could not be determined.
sl@0:  * @publishedPartner
sl@0:  * @deprecated
sl@0:  */
sl@0: EXPORT_C TInt RFeatureRegistry::QuerySupportS(TUid aFeatureUid)
sl@0: 	{
sl@0: 	TUint32 dummyInfo;
sl@0: 	return QuerySupportS(aFeatureUid, dummyInfo);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0:  * Queries support for feature on the device.
sl@0:  * Static version recommended for single queries.
sl@0:  *
sl@0:  * @param aFeatureUid Unique identifier of feature being queried
sl@0:  * @param aInfo addition status information about feature
sl@0:  * @return positive value if feature is supported, zero if feature is not supported,
sl@0:  *     or negative system-wide error code if could not be determined.
sl@0:  * @publishedPartner
sl@0:  * @deprecated
sl@0:  */
sl@0: EXPORT_C TInt RFeatureRegistry::QuerySupportS(TUid aFeatureUid, TUint32& aInfo)
sl@0: 	{
sl@0: 	CTrapCleanup * cleanup = NULL;
sl@0: 	if(User::TrapHandler() == NULL)
sl@0: 		{
sl@0: 		cleanup = CTrapCleanup::New();
sl@0: 		if(cleanup == NULL)
sl@0: 	        {
sl@0: 	        return KErrNoMemory;
sl@0: 	        }
sl@0: 		}
sl@0: 	TBool supported = EFalse;
sl@0: 	TRAPD( err,  supported = CFeatureDiscovery::IsFeatureSupportedL(aFeatureUid) );
sl@0: 	
sl@0: 	if(cleanup != NULL)
sl@0: 		delete cleanup;
sl@0:      
sl@0: 	if (err != KErrNone)
sl@0: 		{
sl@0: 		return err;
sl@0: 		}
sl@0: 		
sl@0:     if ( supported)
sl@0:         {
sl@0: 		//FeatReg support only ROM features so EStatusUpgradableBit has no meaning
sl@0: 		//So aInfo always set to EStatusSupportBit in this wrapper
sl@0: 		aInfo = EStatusSupportBit;
sl@0: 		return EStatusSupportBit;		
sl@0:         }
sl@0:    
sl@0: 	// feature not supported
sl@0: 	aInfo =0;
sl@0: 	return 0;
sl@0: 
sl@0: 	}
sl@0: 	
sl@0: 
sl@0: // CLASS DECLARATION
sl@0: 
sl@0: /**
sl@0: Dummy class. Contains placeholder for a removed RFeatureRegistryNotify function to prevent BC break.
sl@0: @internalComponent
sl@0: */
sl@0: class Dummy
sl@0:     {
sl@0: 
sl@0:     public: // New functions
sl@0: 
sl@0:         IMPORT_C static void Dummy1();
sl@0:         IMPORT_C static void Dummy2();
sl@0:         IMPORT_C static TInt Dummy3();
sl@0:         IMPORT_C static void Dummy4(TRequestStatus &);
sl@0:     };
sl@0: 
sl@0: // ================= MEMBER FUNCTIONS =======================
sl@0: 
sl@0: 
sl@0: /**
sl@0: Dummy method
sl@0: @internalComponent
sl@0: */
sl@0: EXPORT_C void Dummy::Dummy1() { }
sl@0: 
sl@0: /**
sl@0: Dummy method
sl@0: @internalComponent
sl@0: */
sl@0: EXPORT_C void Dummy::Dummy2() {  }
sl@0: /**
sl@0: Dummy method
sl@0: @internalComponent
sl@0: @return KErrNotSupported
sl@0: */
sl@0: EXPORT_C TInt Dummy::Dummy3() 
sl@0: {  
sl@0: return KErrNotSupported;
sl@0: }
sl@0: 
sl@0: /**
sl@0: Dummy method
sl@0: @internalComponent
sl@0: */
sl@0: EXPORT_C void Dummy::Dummy4(TRequestStatus &) {  }
sl@0: 
sl@0: 
sl@0: 
sl@0: 
sl@0: