Collapse all Symbian^3 Application Developer Library

CDefaultResolver Class Reference

class CDefaultResolver : public CResolver

Since: 7.0 Controls the identification, (resolution), of which implementation will be used to satisfy an interface implementation instantiation.

Inherits from

CDefaultResolver
- CResolver
  - CBase

Public Member Functions
	~CDefaultResolver ()
TUid	IdentifyImplementationL ( TUid , const TEComResolverParams &)
RImplInfoArray *	ListAllL ( TUid , const TEComResolverParams &)
CDefaultResolver *	NewL ( MPublicRegistry &)

Protected Member Functions
	CDefaultResolver ( MPublicRegistry &)
TUid	Resolve (const RImplInfoArray &, const TEComResolverParams &)

Private Member Functions
TBool	Match (const TDesC8 &, const TDesC8 &, TBool )

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()
	CResolver::CResolver(MPublicRegistry &)
	CResolver::ListAllL(TUid)const

Inherited Attributes
	CResolver::iRegistry

Constructor & Destructor Documentation

CDefaultResolver(MPublicRegistry &)

CDefaultResolver

(

MPublicRegistry &

aRegistry

)

[protected, explicit]

Parameters

MPublicRegistry & aRegistry

~CDefaultResolver()

~CDefaultResolver

(

)

Intended Usage : Standard default d'tor Error Condition : None

Since: 7.0

Member Functions Documentation

IdentifyImplementationL(TUid, const TEComResolverParams &)

TUid	IdentifyImplementationL	(	TUid	aInterfaceUid,
			const TEComResolverParams &	aAdditionalParameters
		)	const [virtual]

Intended Usage : Request that the resolver identify the most appropriate interface implementation. Error Condition :

Since: 7.0

Pre-condition: Object is fully constructed and initialized

Post-condition: Registry contents are not modified but registry keys may be updated

Parameters

TUid aInterfaceUid	The interface for which implementations are requested
const TEComResolverParams & aAdditionalParameters	Data to be used to refine the search further

ListAllL(TUid, const TEComResolverParams &)

RImplInfoArray *	ListAllL	(	TUid	aInterfaceUid,
			const TEComResolverParams &	aAdditionalParameters
		)	const [virtual]

Intended Usage : List all the implementations which satisfy the specified interface. Error Condition :

Since: 7.0

Pre-condition: Object is fully constructed and initialized

Post-condition: Registry contents are not modified but registry keys may be updated

Parameters

TUid aInterfaceUid	The interface for which implementations are requested
const TEComResolverParams & aAdditionalParameters	Data to be used to refine the search further

Match(const TDesC8 &, const TDesC8 &, TBool)

TBool	Match	(	const TDesC8 &	aImplementationType,
			const TDesC8 &	aMatchType,
			TBool	aUseWildcards
		)	const [private]

Intended Usage : Searches for a match of a data type on an implementation type. Match returns ETrue if aMatchType is found within aImplementationType according to the following rules: 1) aImplementationType is treated as a series of descriptors separated by double bars (||). ETrue is returned if aMatchType matches exactly any of the short descriptors. If no double bar is present then aImplementationType is treated as a single descriptor. 2) If aUseWildcards == ETrue then a '?' in aMatchType will be matched to any single character and '*' will be matched to any series of characters.

leave: KErrNoMemory

Since: 7.0

Pre-condition: This object is fully constructed

Parameters

const TDesC8 & aImplementationType	The implementation data type to search for a match
const TDesC8 & aMatchType	The data to search for
TBool aUseWildcards	ETrue if wildcard matching should be allowed

NewL(MPublicRegistry &)

CDefaultResolver *

NewL

(

MPublicRegistry &

aRegistry

)

[static]

Parameters

MPublicRegistry & aRegistry

Resolve(const RImplInfoArray &, const TEComResolverParams &)

TUid	Resolve	(	const RImplInfoArray &	aImplementationsInfo,
			const TEComResolverParams &	aAdditionalParameters
		)	const [protected]

Intended Usage : Called by IdentifyImplementationL to select an appropriate implementation from a list of possibles

Since: 7.0

Pre-condition: This object is fully constructed

Parameters

const RImplInfoArray & aImplementationsInfo	Information on the potential implementations
const TEComResolverParams & aAdditionalParameters	The data to match against to detemine the implementation