TEComResolverParams Class Reference

#include <ecom/ecomresolverparams.h>

Link against: ErrorConcealmentIntfcMsgHdlr.lib

class TEComResolverParams

Detailed Description

Used to pass values to a Resolver to aid in the filtering of Interface Implementation plugins. These values are considered match characteristics used during resolution of these Interface Implementation. It is a class used in the ECOM API provided by the REComSession class. This class DOES NOT own the descriptor data iDataType points to and so it will not release the data on descruction. This is the responsibility of the user of this class.

See also: REComSession

Constructor & Destructor Documentation

TEComResolverParams ( )

TEComResolverParams()[inline]

Member Function Documentation

DataType ( )

const TDesC8 &DataType()const [inline]

Provides read access to the Interface Implementation plugin 'datatype' match pattern. Note, since TEComResolveParams has a default constructor this data member may be an invalid descriptor which implies 'default matching'.

Pre-condition
The object is constructed

Returns: The read only 'datatype' match pattern.

IsGenericMatch ( )

TBool IsGenericMatch()const [inline]

Check if 'generic' matching is allowed.

Pre-condition
The object is constructed

Returns: ETrue if generic matching is allowed, EFalse otherwise.

IsWildcardMatch ( )

TBool IsWildcardMatch()const [inline]

SetDataType ( const TDesC8 & )

voidSetDataType(const TDesC8 &aDataType)[inline]

Set the Interface Implementation plugin 'datatype' match pattern.

Pre-condition
The object is constructed
Post-condition
iDataType equals aDataType.
ParameterDescription
aDataTypeThe 'datatype' match pattern to be stored.

SetGenericMatch ( TBool )

voidSetGenericMatch(TBoolaGenericMatch)[inline]

Indicates that a 'generic' match is required.

Either allow Interface Implementation plugins that are specific (use no wildcards in their registry file) or generic (use wildcards in their registry file).

In any case the user of a should NOT use wildcards in the datatype string that is passed into this object.

Rationale: The client that sets up the resolver is expected to know what type of data it is handling.

Use Case: "I have this gif to convert, but I'd prefer only gif-specific plugins" or "I have this gif to convert, but I'm happy with some generic image conversion plugin".

NOT: "I have this image I want some plugin to convert, but I don't know the type of the image".

Pre-condition
The object is constructed
Post-condition
iGenericMatch equals aGenericMatch.
ParameterDescription
aGenericMatchETrue if a generic match is required, EFalse if not.

SetWildcardMatch ( TBool )

voidSetWildcardMatch(TBoolaWildcardMatch)[inline]