Class CResolver

class CResolver : public CBase;

Description

Abstract base class which is used to identify the correct interface implementation based on criteria supplied by the client. This base class can be used to write a client specific resolver, however this is not required as a default implementation is provided within ECom.

Derivation

• CBase - Base class for all classes to be instantiated on the heap

• CResolver - Abstract base class which is used to identify the correct interface implementation based on criteria supplied by the client

Members

Defined in CResolver:
IdentifyImplementationL(), ListAllL(), ListAllL(), iRegistry

Inherited from CBase:
Delete(), Extension_(), operator new()

virtual TUid IdentifyImplementationL(TUid aInterfaceUid, const TEComResolverParams &aAdditionalParameters) const=0;

Pre-Condition

This object is fully constructed.

Description

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

Parameters

TUid aInterfaceUid The interface for which an implementation is requested const TEComResolverParams &aAdditionalParameters The parameters which must match for an implementation to be suitable

Return value

TUid The unique Id of the implementation which satisfies the specified parameters.

virtual RImplInfoArray *ListAllL(TUid aInterfaceUid, const TEComResolverParams &aAdditionalParameters) const=0;

Pre-Condition

Object is fully constructed and initialized

Description

Intended Usage : List all the implementations which satisfy the specified interface definition and the resolve parameters supplied. Error Condition : Depends on implementation.

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 The parameters which must match for an implementation to be suitable

Return value

RImplInfoArray * Pointer to an array of suitable implementations. Ownership of this array is passed to the calling function.

inline RImplInfoArray &ListAllL(TUid aInterfaceUid) const;

Pre-Condition

Object is fully constructed and initialized

Description

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

Post-Condition

Registry contents are not modified but registry keys may be updated

Parameters

TUid aInterfaceUid The interface for which implementations are requested

Return value

RImplInfoArray & Array of suitable implementations

protected: const MPublicRegistry & iRegistry;

Description

A reference to the instantiated registry information