// under the terms of "Eclipse Public License v1.0"

// at the URL "http://www.eclipse.org/legal/epl-v10.html".

// This file contains the definition of the CImplementationInformation API class.

/**

 @file

 @publishedAll

 @released

*/

// ____________________________________________________________________________

// INCLUDES

// ____________________________________________________________________________

// TYPES

/**

Simplifies the definition of extended interfaces array

@publishedPartner

// To be used internally by ECOM and by Phone Manufacturers

typedef RArray<TUid> RExtendedInterfacesArray;

// ____________________________________________________________________________

// CLASSES

/**

The CimplementationInformation class acts as the container for the registration 

data relating to a particular interface implementation.

Note that this class is used in both the ECOM client and server side hence the 

mixed API classification seen below. For the client side only the API used to 

extract the registration data should be used.

*/

public: // internalComponent APIs

    	// Internal methods used only inside ECOM , not for client use.

	static CImplementationInformation* NewLC(TBool aClientSide,

                                             RReadStream& aStream);

	static CImplementationInformation* NewL(TUid	aUid,

											TInt	aVersion,

	static CImplementationInformation* NewL(TUid	aUid,

											TInt	aVersion,

											HBufC*  aName,

											HBufC8* aDataType,

											HBufC8* aOpaqueData,

											TDriveUnit aDrive,

											TBool aRomOnly,

											TBool aRomBased,

											RExtendedInterfacesArray* aExtendedInterfaces);

public: // publishedAll APIs

        // Available for use by all clients

	inline const TDesC8& OpaqueData() const;

	inline TUid ImplementationUid() const;

	inline TInt Version() const;

	inline TDriveUnit Drive() const;

	inline TBool RomOnly() const;

	inline TBool RomBased() const;

	inline TVendorId VendorId() const;

	// This function should not be used by any ECOM client as it will have no 

    // effect at all on the implementation information stored in the server side

	IMPORT_C void GetExtendedInterfaceListL(RExtendedInterfacesArray& aList);

public: // internalComponent APIs

    	// Internal methods used inside ECOM, not for client use.

	void InternalizeL(TBool aClientSide,RReadStream& aStream);

	void AddExtendedInterfaceL(const TUid& aExtendedInterface); 	

	RExtendedInterfacesArray* GetExtendedInterfaceList();

private: // internalComponent APIs

         // Internal methods used inside ECOM, not for client use.

	CImplementationInformation(TUid aUid,

							   TInt aVersion,

							   HBufC*  aName,

    CImplementationInformation(TUid aUid,

							   TInt aVersion,

							   HBufC*  aName,

							   HBufC8* aDataType,

							   HBufC8* aOpaqueData,

							   TDriveUnit aDrive,

							   TBool aRomOnly,

							   TBool aRomBased,

							   RExtendedInterfacesArray* aExtendedInterfaces);

	/** The implementation version */

	TInt		iVersion;

	/** This implementations human readable name intended for display in 

	    UI implementations */

	/** The type of data this implementation is registered to handle :

	Used for matching against the run-time cue provided by the client

	during default interface implementation resolution.

	*/

	/** Data registered for this implementation which can be used by the client

	during non-default resolution operations but is ignored by the framework.

	/** The flag recording if this implementation is disabled or enabled */

	/** The drive that this plug-in resides on */

	/** The flag recording whether this implementation may only be loaded

	/** This flag records whether this implementation was discovered on

	/** Array of extended interfaces.*/

	RExtendedInterfacesArray* iExtendedInterfaceList;

// ____________________________________________________________________________

// TYPES

/**

Simplifies the definition of functions which return registry information

/**

Simplifies the definition of functions which return registry information

// ____________________________________________________________________________

// INLINES