1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/os/ossrv/lowlevellibsandfws/pluginfw/Framework/frame/RomOnlyResolver.h	Fri Jun 15 03:10:57 2012 +0200
     1.3 @@ -0,0 +1,102 @@
     1.4 +// Copyright (c) 2002-2009 Nokia Corporation and/or its subsidiary(-ies).
     1.5 +// All rights reserved.
     1.6 +// This component and the accompanying materials are made available
     1.7 +// under the terms of "Eclipse Public License v1.0"
     1.8 +// which accompanies this distribution, and is available
     1.9 +// at the URL "http://www.eclipse.org/legal/epl-v10.html".
    1.10 +//
    1.11 +// Initial Contributors:
    1.12 +// Nokia Corporation - initial contribution.
    1.13 +//
    1.14 +// Contributors:
    1.15 +//
    1.16 +// Description:
    1.17 +//
    1.18 +
    1.19 +
    1.20 +#ifndef __ROMONLYRESOLVER_H__
    1.21 +#define __ROMONLYRESOLVER_H__
    1.22 +
    1.23 +#include "DefaultResolver.h"
    1.24 +#include "RegistryData.h"
    1.25 +
    1.26 +class TEComResolverParams;
    1.27 +
    1.28 +/**
    1.29 +	@internalComponent
    1.30 +	@since 7.0
    1.31 +	Special resolver which controls the identification, (resolution), of which implementation 
    1.32 +	will be used to satisfy an interface implementation instantiation. This version only allows
    1.33 +	plug-ins which are installed in ROM or are updates of ones originally found in ROM.
    1.34 + */
    1.35 +class CRomOnlyResolver : public CDefaultResolver
    1.36 +{
    1.37 +public:
    1.38 +/**
    1.39 +	@fn				NewL(CRegistryData& aRegistry)
    1.40 +	Intended Usage	: Standardized safe construction which leaves nothing 
    1.41 +					on the cleanup stack.	
    1.42 +	Error Condition	: Cannot fully construct because of memory limitations.	
    1.43 +	@leave			KErrNoMemory
    1.44 +	@since			7.0
    1.45 +	@return			A pointer to the new class
    1.46 +	@post			CRomOnlyResolver is fully constructed, 
    1.47 +					and initialized.
    1.48 + */
    1.49 +	static CRomOnlyResolver* NewL(MPublicRegistry& aRegistry);
    1.50 +
    1.51 +/**
    1.52 +	@fn				~CRomOnlyResolver()
    1.53 +	Intended Usage	: Standard default d'tor	
    1.54 +	Error Condition	: None	
    1.55 +	@since			7.0
    1.56 + */
    1.57 +	~CRomOnlyResolver();
    1.58 +
    1.59 +/**
    1.60 +	@fn				IdentifyImplementationL(TUid aInterfaceUid, 
    1.61 +											const TEComResolverParams& aAdditionalParameters) const
    1.62 +	Intended Usage	:	Request that the resolver identify the most appropriate 
    1.63 +						interface implementation.
    1.64 +	Error Condition	:	
    1.65 +	@since			7.0
    1.66 +	@param			aInterfaceUid The interface for which implementations are requested
    1.67 +	@param			aAdditionalParameters Data to be used to refine the search further
    1.68 +	@return			The Uid of the best fit interface implementation - KNullUid if no match is found
    1.69 +	@pre 			Object is fully constructed and initialized
    1.70 +	@post			Registry contents are not modified but registry keys may be updated
    1.71 + */
    1.72 +	TUid IdentifyImplementationL(TUid aInterfaceUid, 
    1.73 +								 const TEComResolverParams& aAdditionalParameters)const ;
    1.74 +
    1.75 +/**
    1.76 +	@fn				ListAllL(TUid aInterfaceUid, 
    1.77 +							 const TEComResolverParams& aAdditionalParameters) const
    1.78 +	Intended Usage	:	List all the implementations which satisfy the specified interface.
    1.79 +	Error Condition	:	
    1.80 +	@since			7.0
    1.81 +	@param			aInterfaceUid The interface for which implementations are requested
    1.82 +	@param			aAdditionalParameters Data to be used to refine the search further
    1.83 +	@return			Pointer to an array of suitable implementations. Ownership of this array
    1.84 +	is passed to the calling function.
    1.85 +	@pre 			Object is fully constructed and initialized
    1.86 +	@post			Registry contents are not modified but registry keys may be updated
    1.87 + */
    1.88 +	RImplInfoArray* ListAllL(TUid aInterfaceUid, 
    1.89 +							 const TEComResolverParams& aAdditionalParameters)const ;
    1.90 +
    1.91 +private:
    1.92 +/**
    1.93 +	@internalComponent
    1.94 +	@fn				CRomOnlyResolver(CRegistryData& aRegistry)
    1.95 +	Intended Usage	: Standardized default c'tor	
    1.96 +	Error Condition	: None	
    1.97 +	@since			7.0
    1.98 +	@post			CRomOnlyResolver is fully constructed
    1.99 + */
   1.100 +	explicit CRomOnlyResolver(MPublicRegistry& aRegistry);
   1.101 +
   1.102 +};
   1.103 +
   1.104 +#endif // __ROMONLYRESOLVER_H__
   1.105 +