sl@0: // Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0: // All rights reserved.
sl@0: // This component and the accompanying materials are made available
sl@0: // under the terms of "Eclipse Public License v1.0"
sl@0: // which accompanies this distribution, and is available
sl@0: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: //
sl@0: // Initial Contributors:
sl@0: // Nokia Corporation - initial contribution.
sl@0: //
sl@0: // Contributors:
sl@0: //
sl@0: // Description:
sl@0: // Definition of the CDiscoverer class
sl@0: // 
sl@0: //
sl@0: 
sl@0: /**
sl@0:  @file
sl@0:  @internalComponent
sl@0: */
sl@0: 
sl@0: #ifndef __DISCOVERER_H__
sl@0: #define __DISCOVERER_H__
sl@0: 
sl@0: #include <e32base.h>
sl@0: #include <f32file.h>
sl@0: #include <e32property.h> // for RProperty
sl@0: #include <domaindefs.h> // for TDmDomainState
sl@0: 
sl@0: #include "DiscovererObserver.h"	// The MDiscovererObserver class
sl@0: #include "EComEntry.h"
sl@0: #include "EComEntryBase.h"
sl@0: #include "callback.h"
sl@0: 
sl@0: // Platsec path to binaries
sl@0: _LIT(KSysBin,"\\sys\\bin\\");
sl@0: // Platsec path to resources
sl@0: _LIT(KResourcePlugins,"\\resource\\plugins\\");
sl@0: _LIT(KDllExtension,".dll");
sl@0: 
sl@0: _LIT(KRscExtension,".rsc");
sl@0: 
sl@0: // Length of extension of file name.
sl@0: //The language extension length including the "." is assumed to be 4 
sl@0: const TInt KExtensionLength=4;
sl@0: 
sl@0: //Max lenth for plugin resource path
sl@0: const TInt32 KEComPlugRSCPathMaxLen	=	50;
sl@0: 
sl@0: //class forward declare
sl@0: class CEnvironmentChangeNotifier;
sl@0: /**
sl@0: 	@internalComponent
sl@0: 	@since 7.0
sl@0: 	Responsible for Interface Implementation Collections,
sl@0: 	installed in the Interface Implementation Collection directories.
sl@0:  */
sl@0: 
sl@0: class CDiscoverer : public CBase 
sl@0: {
sl@0: public:
sl@0: 
sl@0: /** Transition flag for Notification*/
sl@0: 	enum TNotificationFlag
sl@0: 	{
sl@0: 	/** A new plugin added or removed*/
sl@0: 	EPluginsModified,
sl@0: 	
sl@0: 	/**should do a rediscovery */
sl@0: 	EPluginsRediscover
sl@0: 	};
sl@0: 
sl@0: /** State declaration for CDiscoverer */	
sl@0: 
sl@0: 	enum TDiscovererState
sl@0: 	{
sl@0: 	/** Undefined state */
sl@0: 	EDisc_Undefined,
sl@0: 	
sl@0: 	/** Initialize state */
sl@0: 	EDisc_NoPluginsDisc,
sl@0: 	
sl@0: 	/** Discover plugins on Ro Internal drive units */
sl@0: 	EDisc_CriticalPluginsDisc,
sl@0: 	
sl@0: 	/** All plugins are discovered.*/
sl@0: 	EDisc_AllPluginsDisc,
sl@0: 	
sl@0: 	/** Plugins added or removed, going to rediscover all plugins */
sl@0: 	EDisc_PluginsDirty
sl@0: 	
sl@0: 	};
sl@0: 
sl@0: /**
sl@0: 	@fn				NewL(MDiscovererObserver& aDiscovererObserver, RFs& aFs)
sl@0: 	Intended Usage	: Standardised safe construction which leaves nothing
sl@0: 					  on the cleanup stack.
sl@0: 	Error Condition	: Not enough memory available.	
sl@0: 	@leave  		KErrNoMemory
sl@0: 	@since			7.0
sl@0: 	@param			aDiscovererObserver A reference to the owning client 
sl@0: 					of the CDiscoverer
sl@0: 	@param			aFs A reference to a connected file server instance.
sl@0: 	@return			CDiscoverer* a pointer to the new class
sl@0: 	@pre 			None
sl@0: 	@post			CDiscoverer is fully constructed, and initialised.
sl@0:  */
sl@0: 	
sl@0: 	static CDiscoverer* NewL(MDiscovererObserver& aDiscovererObserver, RFs& aFs);
sl@0: 
sl@0: /**
sl@0: 	@fn				~CDiscoverer()
sl@0: 	Intended Usage	: Standard default d'tor	
sl@0: 	Error Condition	: None	
sl@0: 	@since			7.0
sl@0: 	@pre 			CDiscoverer is fully constructed.
sl@0: 	@post			CDiscoverer is totally destroyed.
sl@0:  */
sl@0: 	
sl@0: 	~CDiscoverer();
sl@0: 
sl@0: /**
sl@0: 	@fn				Resume()
sl@0: 	Intended Usage	: Re-enable the Discoverer to continue checking for new 
sl@0: 					  interface implementations. 
sl@0: 	Error Condition	: Where resume of the discoverer fails. KErrResumeFailed.
sl@0: 	@since			7.0
sl@0: 	@return			TInt The status of the operation. KErrNone or KErrResumeFailed.
sl@0: 	@pre 			CDiscoverer is fully constructed.
sl@0: 	@post			The operation of the discoverer has been resumed. Or where
sl@0: 					resumption failed, no change.
sl@0:  */
sl@0: 	
sl@0: 	TInt Resume();
sl@0: 
sl@0: /**
sl@0: 	@fn				Suspend()
sl@0: 	Intended Usage	: Temporarily stop looking for new interface implementations.
sl@0: 	Error Condition	: Where suspension of the discoverer fails. KErrSuspendFailed.
sl@0: 	@since			7.0
sl@0: 	@return			TInt The status of the operation. KErrNone or KErrSuspendFailed.
sl@0: 	@pre 			CDiscoverer is fully constructed.
sl@0: 	@post			The operation of the discoverer has been suspended. Or where
sl@0: 					suspend failed, no change.
sl@0:  */
sl@0: 	
sl@0: 	TInt Suspend();
sl@0: 	
sl@0: 	
sl@0: /**
sl@0: 	@fn 			ProcessSSAEventL()
sl@0: 	Intended Usage	: It discovers the plugins on different Drive Units according to 
sl@0: 					the passing state. It will be used by CRegistrar to notify the 
sl@0: 					object of the system start-up state changes.
sl@0: 	@param 			aKnownState the start-up state passing in to CDiscoverer
sl@0: 	@pre			CDiscoverer is fully constructed
sl@0: 	@post			CDiscoverer is notified of the start-up state change
sl@0: */
sl@0: 	void ProcessSSAEventL(TStartupStateIdentifier aKnownState);
sl@0: 	
sl@0: /** 
sl@0: 	@fn 			ProcessDNEventL()
sl@0: 	Intended Usage	:It will be used by one iRscDirNotifier in iRscDirNotifierList 
sl@0: 					to indicate that plugins have been removed or added(state is 
sl@0: 					EDisc_PluginsDirty) and to start a 
sl@0: 					re-discovery(when done, state is EDisc_AllPluginsDisc).
sl@0: 	@leave			KErrNoMemory
sl@0: 	@param			:aFlag the notification transition flag.
sl@0: 	@param			:aDriveUnit a drive which on the plugins has been changed and need to re-discovery
sl@0: 	@pre 			:CDiscoverer is fully constructed.
sl@0: 	@post			: state will be changed, and a re-discovery will happen 
sl@0: 					if the current state is EDisc_PluginsDirty. 
sl@0: */
sl@0: 	void ProcessDNEventL(TNotificationFlag aFlag, const TDriveUnit& aDriveUnit);
sl@0: 
sl@0: /**
sl@0: 	@fn 			State()
sl@0: 	Intended Usage	:Retrieve the object's current state.
sl@0: 	@return 		TDiscovererState the CDiscoverer's current state.
sl@0: 	@pre			CDiscoverer is fully constructed.
sl@0: 	@post 			the CDiscoverer's current state has been returned.
sl@0: */
sl@0: 	TDiscovererState State() const;
sl@0: 	
sl@0: /** Set the iSwiChangeCallBack member
sl@0: @param aCallBack new value for iSwiChangeCallBack
sl@0: */
sl@0: 	void SetSwiChangeCallBack(const TCallBackWithArg& aCallBack);
sl@0: 
sl@0: /** Set the iBurChangeCallBack member
sl@0: @param aCallBack new value for iBurChangeCallBack
sl@0: */
sl@0: 	void SetBurChangeCallBack(const TCallBackWithArg& aCallBack);
sl@0: 
sl@0: private:
sl@0: /**
sl@0: 	@internalComponent
sl@0: 	@fn				CDiscoverer(MDiscovererObserver& aDiscovererObserver, RFs& aFs)
sl@0: 	Intended Usage	: Standardised default c'tor	
sl@0: 	Error Condition	: None	
sl@0: 	@since			7.0
sl@0: 	@param			aDiscovererObserver A reference to the owning client 
sl@0: 					of the CDiscoverer
sl@0: 	@param			aFs A reference to an connected file server instance.
sl@0: 	@pre 			None
sl@0: 	@post			CDiscoverer is fully constructed
sl@0:  */
sl@0: 	
sl@0: 	CDiscoverer(MDiscovererObserver& aDiscovererObserver, RFs& aFs);
sl@0: 
sl@0: /**
sl@0: 	@fn				ConstructL()
sl@0: 	Intended Usage	: Standardised 2nd, (Initialisation) phase of two phase construction.
sl@0: 	Error Condition	: Leaves with error code : usually KErrNoMemory.
sl@0: 	@leave  		KErrNoMemory.
sl@0: 	@since			7.0
sl@0: 	@return			void 
sl@0: 	@pre 			CDiscoverer is fully constructed.
sl@0: 	@post			CDiscoverer is fully initialised.
sl@0:  */
sl@0: 	
sl@0: 	void ConstructL();
sl@0: 
sl@0: /**
sl@0: 	@fn				NotificationL(TInt aStatus)
sl@0: 	Intended Usage	: Called by the one object of iRscDirNotifierList when the 
sl@0: 					contents of the Interface Implementation directories
sl@0: 					has changed on a specified drive.
sl@0: 	Error Condition	: None	
sl@0: 	@leave			KErrNoMemory
sl@0: 	@since			7.0
sl@0: 	@param			aDriveUnit a drive which has changes.
sl@0: 	@return			ETrue to indicate the notifier should re-activate.
sl@0: 	@pre 			CDiscoverer is fully constructed.
sl@0: 	@post			CDiscoverer has been notified that a re-scan of the 
sl@0: 					plugin directories is required.
sl@0:  */
sl@0: 	
sl@0: 	TBool NotificationL(TInt aStatus, const TDriveUnit& aDriveUnit);
sl@0: 
sl@0: /**
sl@0: 	@fn				SwiChangeNotificationL(TInt aSwiOperation)
sl@0: 	Intended Usage	: Called by iSwiChangeNotifier when it is notified of a
sl@0: 					SWI changed.
sl@0: 	Error Condition	: None	
sl@0: 	@since			9.2
sl@0: 	@param			aSwiOperation the SWI operation that is currently taking place
sl@0: 	@pre 			CDiscoverer is fully constructed.
sl@0: 	@post			CDiscoverer has been notified that a re-scan of the
sl@0: 					removable plugin directories is required and has stored current
sl@0: 					SWI operation.
sl@0:  */
sl@0: 	
sl@0: 	void SwiChangeNotificationL(TInt aSwiOperation);
sl@0: 
sl@0: /**
sl@0: 	@fn				LanguageChangeNotificationL()
sl@0: 	Intended Usage	: Called by iLanguageChangeNotifier when it is notified of language
sl@0: 					downgrade path changed.
sl@0: 	Error Condition	: None	
sl@0: 	@since			9.3
sl@0: 	@pre 			CDiscoverer is fully constructed.
sl@0: 	@post			CDiscoverer has been notified that a rescan may be required
sl@0:  */
sl@0:  	
sl@0: 	void LanguageChangeNotificationL();
sl@0: 
sl@0: 	// Methods used by the Incremental Directory Scanning mechanism
sl@0: 
sl@0: /**
sl@0: 	@fn				void RediscoveryScanDirectoryL()
sl@0: 	Intended Usage	: Perform a scan on the Interface Implementation 
sl@0: 					Collection directories on a specified drive.
sl@0: 	Error Condition	: Not enough memory available	
sl@0: 	@leave  		KErrNoMemory
sl@0: 	@since			7.0
sl@0: 	@param			:A drive on which the directory is scanned.
sl@0: 	@return			void
sl@0: 	@pre 			CDiscoverer is fully constructed.
sl@0: 	@post			The scan of the Interface Implementation Collection 
sl@0: 					directories has processed on a specified drive.
sl@0:  */
sl@0: 	
sl@0: 	void RediscoveryScanDirectoryL(const TDriveUnit& aDriveUnit);
sl@0: 
sl@0: /**
sl@0: 	@fn				void ScanDirectoryCancel()
sl@0: 	Intended Usage	: Cancel any scan of the Interface Implementation Collection 
sl@0: 					directories in progress.
sl@0: 	Error Condition	: None	
sl@0: 	@since			7.0
sl@0: 	@return			void 
sl@0: 	@pre 			CDiscoverer is fully constructed.
sl@0: 	@post			The re-scan of the Interface Implementation 
sl@0: 					Collection directories has beed aborted.
sl@0:  */
sl@0: 	
sl@0: 	void ScanDirectoryCancel();
sl@0: 	
sl@0: /**
sl@0: 	@fn				CompleteNotificationProcessing()
sl@0: 	Intended Usage	: Signal that the directory change notification has
sl@0: 					 been fully processed on all drives.
sl@0: 	Error Condition	: None	
sl@0: 	@since			7.0
sl@0: 	@pre 			CDiscoverer is fully constructed.
sl@0: 	@post			An asynchronous re-scan of the Interface Implementation 
sl@0: 					Collection directories is complete.
sl@0:  */
sl@0: 	
sl@0: 	void CompleteNotificationProcessing();
sl@0: 
sl@0: /**
sl@0: 	@fn				ValidateEntryL(const TEntry& aEntry, const TDriveName& aDriveName, CPluginBase*& aEntryToFill,TBool aIsRO)
sl@0: 	Intended Usage	: Verify that a Interface Implementation Collection directories entry is valid
sl@0: 					discovery.
sl@0: 	Error Condition	: No memory
sl@0: 	@leave  		KErrNoMemory
sl@0: 	@since			9.1
sl@0: 	@param			aEntry	A directory entry for an Interface Implementation Collection.
sl@0: 	@param			aDriveName	The drive containing this entry
sl@0: 	@param			aEntryToFill A newly created directory entry with the 
sl@0: 					filename updated to include the full path.
sl@0: 	@param			aIsRO	Indicates whether current drive is Read Only
sl@0: 	@pre 			CDiscoverer is fully constructed, 
sl@0: 					aEntry, aPath and aEntryToFill are all valid references.
sl@0: 	@post			aEntryToFill is created and valid, with the full path and filename as its name entry.
sl@0:  */
sl@0: 	
sl@0: 	void ValidateEntryL(const TEntry& aEntry, const TDriveName& aDriveName, CPluginBase*& aEntryToFill, TBool aIsRO);
sl@0: 
sl@0: /**
sl@0: 	@fn				ValidateEntryL(RResourceArchive& aRscArchive,CPluginBase*& aEntryToFill);
sl@0: 	Intended Usage	: Verify that a Interface Implementation Collection directories entry is valid
sl@0: 					discovery.
sl@0: 	Error Condition	: No memory
sl@0: 	@leave  		KErrNoMemory
sl@0: 	@since			9.1
sl@0: 	@param			aRscArchive A referernce to the resource archive
sl@0: 	@param			aEntryToFill A newly created directory entry with the 
sl@0: 					filename updated to include the full path.
sl@0: 	@pre 			CDiscoverer is fully constructed, 
sl@0: 	@post			aEntryToFill is created and valid, with the full path and filename as its name entry.
sl@0:  */
sl@0: 	
sl@0: 	void ValidateEntryL(RResourceArchive& aRscArchive, CPluginBase*& aEntryToFill);
sl@0: /**
sl@0: 	@fn				ProcessEntryL(const TDriveName& aDrive,CPluginBase*& aEntry, TBool aAnyDllDiscovered)
sl@0: 	Intended Usage	: Verify that a Interface Implementation Collection directories entry is valid
sl@0: 					discovery.
sl@0: 	Error Condition	: Depends on the observer implementation.	
sl@0: 	@leave  		Depends on the observer implementation. (@see CRegistrar).
sl@0: 	@since			9.1
sl@0: 	@param			aDrive the drive name containing this entry
sl@0: 	@param			aEntry	A directory entry for an Interface Implementation Collection.
sl@0: 	@param			aAnyDllDiscovered a flag to tell if any Dll is discovered in the drive.
sl@0: 	@pre 			CDiscoverer is fully constructed.
sl@0: 	@post			The directory entry has been processed by the observer.
sl@0:  */
sl@0: 	
sl@0: 	void ProcessEntryL(const TDriveName& aDrive, CPluginBase*& aEntry, TBool aAnyDllDiscovered);
sl@0: 
sl@0: /**
sl@0: 	@fn				DriveMountedL(TDriveUnit aDrive)
sl@0: 	Intended Usage	: Signal a drive is available.
sl@0: 	Error Condition	: Depends on the observer implementation.	
sl@0: 	@leave  		Depends on the observer implementation. @see CRegistrar.
sl@0: 	@since			7.0
sl@0: 	@param			aDrive	The drive to be noted as available.
sl@0: 	@return			void. 
sl@0: 	@pre 			CDiscoverer is fully constructed.
sl@0: 	@post			The drive mount has been signalled to the observer.
sl@0:  */
sl@0: 	
sl@0: 	void DriveMountedL(TDriveUnit aDrive);
sl@0: 
sl@0: /**
sl@0: 	@fn				DriveUnmountedL(TDriveUnit aDrive)
sl@0: 	Intended Usage	: Signal a drive is unavailable.
sl@0: 	Error Condition	: Leaves with an error code
sl@0: 	@leave			KErrNoMemory
sl@0: 	@since			7.0
sl@0: 	@param			aDrive	The drive to be noted as unavailable.
sl@0: 	@pre 			CDiscoverer is fully constructed.
sl@0: 	@post			The drive dismount has been signalled to the observer.
sl@0:  */
sl@0: 	
sl@0: 	void DriveUnmountedL(TDriveUnit aDrive);
sl@0: 	
sl@0: 	
sl@0: 	
sl@0: /**
sl@0: 	@fn 			StartNotifiers()
sl@0: 	Intended Usage	: start the iRscDirNotifierList and iSwiChangeNotifier when EDisc_AllPlugins
sl@0: 					state is reached.
sl@0: 	@pre 			: CDiscoverer is fully constructed. and iRscDirNotifierList and iSwiChangeNotifier
sl@0: 					are fully constructed.
sl@0: 	@post			: iRscDirNotifierList Activate and iSwiChangeNotifier Subscribe methods are called.
sl@0: */
sl@0: 	void StartNotifiers();
sl@0: 	
sl@0: 	
sl@0: /** 
sl@0: 	@fn 			InitialiseEvent()
sl@0: 	Intended Usage	: called during the CDiscoverer's construction 
sl@0: 					to change the state.
sl@0: 	@pre			: non
sl@0: 	@post			: State is changed from EDisc_Undefined to EDisc_NoPluginsDisc.
sl@0: */		
sl@0: 	void InitialiseEvent();
sl@0: 	
sl@0: /**
sl@0: 	@fn				IsAnyDllRegisteredWithDriveL(const TDriveUnit aDrive)
sl@0: 	Intended Usage	: Find if any Dll is registered in the drive.
sl@0: 	@param 			: aDrive the identifier of the drive to find if any Dll is registered.
sl@0: 	@return			: ETrue if any Dll is registered in the drive unit, otherwise EFalse.
sl@0: 	@pre 			: CDiscoverer is fully constructed.
sl@0: 	@post 			: If any Dll registered info will be returned.
sl@0: */	
sl@0: 	TBool IsAnyDllRegisteredWithDriveL(const TDriveUnit aDrive)const ;	
sl@0: 
sl@0: /**
sl@0: 	@fn				SwiOperationInProgress()
sl@0: 	Intended Usage	: Determine if any SWI operation is currently in progress
sl@0: 	@return			: ETrue if any SWI operation is in progress otherwise EFalse.
sl@0: 	@pre 			: CDiscoverer is fully constructed.
sl@0: 	@post 			: None
sl@0: */	
sl@0: 	TBool SwiOperationInProgress() ;
sl@0: 
sl@0: /**
sl@0: 	@fn				LocaleChangedL(TAny*)
sl@0: 	Intended Usage	: Callback function to be attached to an instance of CEnvironmentChangeNotifier to 
sl@0: 					  rebuild registry data. Note that this has to be a static member function.
sl@0: 	@param 			: A parameter to be passed usually with a "this" pointer so that while the function
sl@0: 					  remaining a static function it can access all the member data anyway.
sl@0: 	@return			: ETrue if language downgrade path is changed, otherwise EFalse.
sl@0: 	@pre 			: CDiscoverer is fully constructed.
sl@0: 	@post 			: Call LanguageChangeNotificationL method to rescan resource files.
sl@0: */		
sl@0: 	static TInt LocaleChangedL(TAny*) ;
sl@0: 
sl@0: // Attributes
sl@0: private:
sl@0: 
sl@0: 	// Define the helper classes which handle the 
sl@0: 	// notification processing.
sl@0: 	class CDirChangeNotifier;
sl@0: 	
sl@0: 	
sl@0: 	typedef RPointerArray<CDirChangeNotifier> RDirChangeNotifierPointerArray;
sl@0: 	// Handles notifications of changes to plugin resources directory on list of drives.
sl@0: 	RDirChangeNotifierPointerArray iRscDirNotifierList;
sl@0: 
sl@0: 	class CSwiChangeNotifier;
sl@0: 
sl@0: 	// Handles notifications of changes to SWI
sl@0: 	CSwiChangeNotifier* iSwiChangeNotifier;
sl@0: 
sl@0: 	// Indicates whether a discovery due to SWI changes is pending
sl@0: 	TBool iSwiChangeDiscoveryPending;
sl@0: 
sl@0: 	//Handle notifications of changes to environment (including language switch)
sl@0: 	CEnvironmentChangeNotifier* iLanguageChangeNotifier	;
sl@0: 
sl@0: 	// Stores the current SWI operation
sl@0: 	TInt iSwiOperation;
sl@0: 
sl@0: 	// Indicates whether a discovery due to language changes is pending
sl@0: 	TBool iLanguageChangeDiscoveryPending;
sl@0: 	
sl@0: 	// the current state of CDiscoverer
sl@0: 	TDiscovererState iState;
sl@0: 	
sl@0: 	class CIdleScanningTimer;
sl@0: 
sl@0: 	// A single timer, processes all pending notifications.
sl@0: 	CIdleScanningTimer* iScanningTimer;
sl@0: 	
sl@0: 	class CDirScanner;
sl@0: 
sl@0: 	/** 
sl@0: 		The internal Interface Implementation Collection 
sl@0: 		identifier and registration handler  
sl@0: 	 */
sl@0: 	
sl@0: 	CDirScanner* iDirScanner;
sl@0: 
sl@0: 	/** A reference to the owning client of the CDiscoverer */
sl@0: 	
sl@0: 	MDiscovererObserver& iDiscovererObserver;
sl@0: 
sl@0: 	/** A reference to the connected file server instance */
sl@0: 	
sl@0: 	RFs& iFs;
sl@0: 
sl@0: 	/** The list of existing drives */
sl@0: 	
sl@0: 	RArray<TUint> iDrivesDiscovered;
sl@0: 
sl@0: 	/** cached info of drives A to Z */
sl@0: 	CEComCachedDriveInfo* iCachedDriveInfo;
sl@0: 	
sl@0: 	TCallBackWithArg iSwiChangeCallBack;
sl@0: 	TCallBackWithArg iBurChangeCallBack;
sl@0: 
sl@0: 	// List the internal classes as friends
sl@0: 	friend class CSwiChangeNotifier;
sl@0: 	friend class CDirChangeNotifier;
sl@0: 	friend class CIdleScanningTimer;
sl@0: 	friend class CDirScanner;
sl@0: 	// And the Test bed state accessor
sl@0: 	friend class TDiscoverer_StateAccessor;
sl@0: 
sl@0: 
sl@0: };
sl@0: // __________________________________________________________________________
sl@0: //
sl@0: /**
sl@0: The notification object which uses P&S to monitor SWI KSAUidSoftwareInstallKey 
sl@0: for changes. When SWI is present in the device/ROM this attribute publishes the
sl@0: current state of a software install or uninstall.
sl@0: When its RunL method is called and depending on the install/uninstall state it 
sl@0: notifies its owning CDiscoverer class object to re-scan removable drives.
sl@0: 
sl@0: @internalComponent
sl@0: */
sl@0: class CDiscoverer::CSwiChangeNotifier : public CActive
sl@0: 	{
sl@0: public:
sl@0: 
sl@0: 	/**
sl@0: 		@fn				NewL(CDiscoverer& aDiscoverer)
sl@0: 		Intended Usage	: Standardised safe construction which leaves nothing
sl@0: 						  on the cleanup stack.
sl@0: 		Error Condition	: Not enough memory available.	
sl@0: 		@leave  			KErrNoMemory
sl@0: 		@since			9.2
sl@0: 		@param			aDiscoverer A reference to the owning CDiscoverer
sl@0: 		@return			CSwiChangeNotifier* a pointer to the new class
sl@0: 		@pre 			None
sl@0: 		@post			CSwiChangeNotifier is fully constructed, and initialised.
sl@0: 	 */	
sl@0: 	static CSwiChangeNotifier* NewL(CDiscoverer& aDiscoverer);
sl@0: 
sl@0: 	/**
sl@0: 		@fn				virtual ~CSwiChangeNotifier()
sl@0: 		Intended Usage	: Standard default d'tor	
sl@0: 		Error Condition	: None	
sl@0: 		@since			9.2
sl@0: 		@pre 			CSwiChangeNotifier is fully constructed.
sl@0: 		@post			CSwiChangeNotifier is totally destroyed
sl@0: 	 */
sl@0: 	virtual ~CSwiChangeNotifier();
sl@0: 	
sl@0: 	/**
sl@0: 		@fn				Subscribe()
sl@0: 		Intended Usage	: Subscribes with P&S for change notifications for the 
sl@0:                           SWI KSAUidSoftwareInstallKey property
sl@0: 		Error Condition	: None	
sl@0: 		@since			9.2
sl@0: 		@pre 			CSwiChangeNotifier is fully constructed.
sl@0: 		@post			CSwiChangeNotifier is active on the current scheduler.
sl@0: 	 */
sl@0: 	void Subscribe();
sl@0: 
sl@0: private:
sl@0: 	/**
sl@0: 		@fn				CSwiChangeNotifier(CDiscoverer& aDiscoverer)
sl@0: 		Intended Usage	: Standardised default c'tor	
sl@0: 		Error Condition	: None	
sl@0: 		@since			9.2
sl@0: 		@param			aDiscoverer A reference to its owning class instance.
sl@0: 		@pre 			None
sl@0: 		@post			CSwiChangeNotifier is fully constructed
sl@0: 	 */
sl@0: 	CSwiChangeNotifier(CDiscoverer& aDiscoverer);
sl@0: 
sl@0: 	/**
sl@0: 		@fn				RunL()
sl@0: 		Intended Usage	: When the object activates, this is method is called
sl@0: 						and notifies the CDiscoverer to re-scan the 
sl@0: 						removable drives.. 
sl@0: 		Error Condition	: Not enough memory available to complete the scan.
sl@0: 		@leave  			KErrNoMemory
sl@0: 		@since			9.2
sl@0: 		@pre 			CSwiChangeNotifier is fully constructed.
sl@0: 		@post			CSwiChangeNotifier notifications are subscribed and plugins on
sl@0: 						removable drives have been rediscovered..
sl@0: 	 */
sl@0: 	void RunL();
sl@0: 
sl@0: 	/**
sl@0: 		@fn				void ConstructL()
sl@0: 		Intended Usage	: Standardised 2nd, (Initialisation) phase of two phase construction.
sl@0: 		Error Condition	: Leaves with error code : usually KErrNoMemory.
sl@0: 		@leave  			KErrNoMemory.
sl@0: 		@since			9.2
sl@0: 		@return			void 
sl@0: 		@pre 			CSwiChangeNotifier is fully constructed.
sl@0: 		@post			CSwiChangeNotifier is fully initialised.
sl@0: 	 */
sl@0: 	void ConstructL();
sl@0: 
sl@0: 	/**
sl@0: 		@fn				DoCancel()
sl@0: 		Intended Usage	: The cancel action called by CActive::Cancel(). 
sl@0: 		Error Condition	: None	
sl@0: 		@since			9.2
sl@0: 		@pre 			CSwiChangeNotifier is fully constructed.
sl@0: 		@post			CSwiChangeNotifier notifications are cancelled and
sl@0: 						it is no longer active on the current scheduler.
sl@0: 	 */
sl@0: 	void DoCancel();
sl@0: 
sl@0: 	/**
sl@0: 		@fn				RunError(TInt aError)
sl@0: 		Intended Usage	: Called by the notifier RunL leaving.
sl@0: 		@since			9.2
sl@0: 		@param			aError The error code that the RunL left with.
sl@0: 		@return			TInt KErrNone. 
sl@0: 		@pre 			CSwiChangeNotifier is fully constructed.
sl@0: 		@post			CSwiChangeNotifier is returned to a
sl@0: 						sensible active state.
sl@0: 	 */
sl@0: 	TInt RunError(TInt aError);
sl@0: 
sl@0: private:
sl@0: 	/** A reference to its owning class instance */
sl@0: 	CDiscoverer& iDiscoverer;	
sl@0: 	/** Handle allowing access to P&S properties */
sl@0: 	RProperty iProperty;
sl@0: 	/** Friend class to enable access to private members for testing. */
sl@0: 	friend class TDiscoverer_StateAccessor;
sl@0: 	};
sl@0: 
sl@0: // __________________________________________________________________________
sl@0: //
sl@0: /**
sl@0: 	@internalComponent
sl@0: 	@since 7.0
sl@0: 	The notification object which watches the Interface Implementation Collection directories for
sl@0: 	any changes.
sl@0: 	When its RunL method is called, it notifies its owning CDiscoverer class
sl@0: 	object to re-scan the Interface Implementation Collection directories.
sl@0:  */
sl@0: class CDiscoverer::CDirChangeNotifier : public CActive
sl@0: 	{
sl@0: public:
sl@0: 	/**
sl@0: 		@fn				CDirChangeNotifier(CDiscoverer& aDiscoverer, RFs& aFs, const TDesC& aNotificationFilePath)
sl@0: 		Intended Usage	: Standardised default c'tor	
sl@0: 		Error Condition	: None	
sl@0: 		@since			7.0
sl@0: 		@param			aDiscoverer A reference to its owning class instance.
sl@0: 		@param			aFs A reference to a connected file server instance.
sl@0: 		@param			aNotificationFilePath A reference to the file path that is to be watched.
sl@0: 		@param			aDriveUnit A drive which the notification object watches for.
sl@0: 		@pre 			None
sl@0: 		@post			CDirChangeNotifier is fully constructed
sl@0: 	 */
sl@0: 	CDirChangeNotifier(CDiscoverer& aDiscoverer, RFs& aFs,const TDriveUnit& aDriveUnit);
sl@0: 	/**
sl@0: 		@fn				virtual ~CDirChangeNotifier()
sl@0: 		Intended Usage	: Standard default d'tor	
sl@0: 		Error Condition	: None	
sl@0: 		@since			7.0
sl@0: 		@pre 			CDirChangeNotifier is fully constructed.
sl@0: 		@post			CDirChangeNotifier is totally destroyed
sl@0: 	 */
sl@0: 	virtual ~CDirChangeNotifier();
sl@0: 	/**
sl@0: 		@fn				Activate()
sl@0: 		Intended Usage	: Activate the notifier and attach it to the File 
sl@0: 						session to watch the appropriate Interface Implementation Collection directories. 
sl@0: 		Error Condition	: None	
sl@0: 		@since			7.0
sl@0: 		@pre 			CDirChangeNotifier is fully constructed.
sl@0: 		@post			CDirChangeNotifier is active on the current scheduler.
sl@0: 	 */
sl@0: 	void Activate();
sl@0: 
sl@0: private:
sl@0: 	/**
sl@0: 		@fn				RunL()
sl@0: 		Intended Usage	: When the object activates, this is method is called
sl@0: 						and notifies the CDiscoverer to re-scan the 
sl@0: 						Interface Implementation Collection	directories. 
sl@0: 		Error Condition	: Not enough memory available to complete the scan.
sl@0: 		@leave  		KErrNoMemory
sl@0: 		@since			7.0
sl@0: 		@pre 			CDirChangeNotifier is fully constructed.
sl@0: 		@post			CDirChangeNotifier notifications are cancelled and
sl@0: 						it is no longer active on the current scheduler.
sl@0: 	 */
sl@0: 	void RunL();
sl@0: 	/**
sl@0: 		@fn				DoCancel()
sl@0: 		Intended Usage	: The cancel action called by CActive::Cancel(). 
sl@0: 		Error Condition	: None	
sl@0: 		@since			7.0
sl@0: 		@pre 			CDirChangeNotifier is fully constructed.
sl@0: 		@post			CDirChangeNotifier notifications are cancelled and
sl@0: 						it is no longer active on the current scheduler.
sl@0: 	 */
sl@0: 	void DoCancel();
sl@0: 
sl@0: 	/**
sl@0: 		@fn				RunError(TInt aError)
sl@0: 		Intended Usage	: Called by the notifier RunL leaving.
sl@0: 		@since			7.0
sl@0: 		@param			aError The error code that the RunL left with.
sl@0: 		@return			TInt KErrNone. 
sl@0: 		@pre 			CDirChangeNotifier is fully constructed.
sl@0: 		@post			CDirChangeNotifier is returned to a
sl@0: 						sensible active state.
sl@0: 	 */
sl@0: 	TInt RunError(TInt aError);
sl@0: 
sl@0: private:
sl@0: 	/** A reference to its owning class instance */
sl@0: 	CDiscoverer& iDiscoverer;	
sl@0: 	/** A reference to a connected file server instance */
sl@0: 	RFs&	iFs;
sl@0: 	/** The file path for a specific drivethat we are interested in.*/
sl@0: 	//const TDesC& iNotificationFilePath;
sl@0: 	typedef TBuf<KEComPlugRSCPathMaxLen> TResourcePathName;
sl@0: 	TResourcePathName iNotificationFilePath;
sl@0: 
sl@0: 	/** A drive which the notification object watches for.*/
sl@0: 	TDriveUnit iDriveUnit;
sl@0: 	/** Friend class to enable access to private members for testing. */
sl@0: 	friend class TDiscoverer_StateAccessor;
sl@0: 	};
sl@0: 
sl@0: /**
sl@0: 	@since 7.0	
sl@0: 	The timer Active object for providing incremental plugin directory scanning. 
sl@0: 	Note that task execution is dependant upon the task priority
sl@0: 	The default priority is idle time execution only.
sl@0: 	This object controls the yielding of time to other processes by having a low priority
sl@0: 	but requesting immediate reactivation, after each incremental part of the directory scan.
sl@0: 	It is launched by the CDirChangeNotifier's notification call.
sl@0:  */
sl@0: class CDiscoverer::CIdleScanningTimer : public CTimer
sl@0: 	{
sl@0: public:
sl@0: 	/**
sl@0: 		@fn				NewL(CDiscoverer& aDiscoverer)
sl@0: 		Intended Usage	: Standardised safe construction which leaves nothing
sl@0: 						  on the cleanup stack.
sl@0: 		Error Condition	: Not enough memory available.	
sl@0: 		@leave  		KErrNoMemory
sl@0: 		@since			7.0
sl@0: 		@param			aDiscoverer A reference to the owning CDiscoverer
sl@0: 		@return			CIdleScanningTimer* a pointer to the new class
sl@0: 		@pre 			None
sl@0: 		@post			CIdleScanningTimer is fully constructed, and initialised.
sl@0: 	 */	
sl@0: 	static CIdleScanningTimer* NewL(CDiscoverer& aDiscoverer);
sl@0: 	/**
sl@0: 		@fn				virtual ~CIdleScanningTimer()
sl@0: 		Intended Usage	: Standard default d'tor	
sl@0: 		Error Condition	: None	
sl@0: 		@since			7.0
sl@0: 		@pre 			CIdleScanningTimer is fully constructed.
sl@0: 		@post			CIdleScanningTimer is totally destroyed
sl@0: 	 */
sl@0: 	virtual ~CIdleScanningTimer();
sl@0: 	
sl@0: 	/** 
sl@0: 		@fn				AddDriveL(TDriveUnit aDrive)
sl@0: 		Intended Usage	: Add a drive for processing notification
sl@0: 		Error Condition	: None	
sl@0: 		@leave  		System wide error codes.
sl@0: 		@param			aDrive The drive to be added.
sl@0: 		@post			The drive number added into pending list only if it has not been added before
sl@0: 	 */
sl@0: 	inline void AddDriveL(const TDriveUnit aDrive)
sl@0: 		{
sl@0: 		if(iPendingDriveList.Find(aDrive) == KErrNotFound)
sl@0: 			{
sl@0: 			iPendingDriveList.AppendL(aDrive);
sl@0: 			}
sl@0: 		}
sl@0: 	
sl@0: 	/**
sl@0: 		@fn				IsAnyNotificationProcessingPending()
sl@0: 		Intended Usage	: To check if there is any notification waiting to be processed.
sl@0: 		@return			TBool A flag indicating if there is any pending notification to be processed
sl@0: 	 */	
sl@0: 	inline TBool IsAnyNotificationProcessingPending()
sl@0: 		{
sl@0: 		if(iPendingDriveList.Count())
sl@0: 			return ETrue;
sl@0: 		return EFalse;
sl@0: 		}
sl@0: 	
sl@0: 	/**
sl@0: 		@fn				RestartScanPeriod()
sl@0: 		Intended Usage	: Called to restart the scanning period.
sl@0: 		Error Condition	: None	
sl@0: 		@pre 			CIdleScanningTimer is fully constructed.
sl@0: 		@post			CIdleScanningTimer is activated and will process pending drives list, if the timer has not been suspended
sl@0: 	 */
sl@0: 	void RestartScanPeriod();
sl@0: 	
sl@0: 	/**
sl@0: 		@fn				Suspend()
sl@0: 		Intended Usage	: Called to suspend the scanning timer, disabling the scanning from being restarted.
sl@0: 		Error Condition	: None	
sl@0: 		@pre 			CIdleScanningTimer is fully constructed.
sl@0: 		@post			CIdleScanningTimer is set as suspended. No re-discovery will take place.
sl@0: 	 */
sl@0: 	void Suspend();
sl@0: 	
sl@0: 	/**
sl@0: 		@fn				Resume()
sl@0: 		Intended Usage	: Called to resume the scanning timer, and enable scanning to be restarted.
sl@0: 		Error Condition	: None	
sl@0: 		@pre 			CIdleScanningTimer is fully constructed.
sl@0: 		@post			CIdleScanningTimer is set as resumed. Re-discovery will take place.
sl@0: 	 */
sl@0: 	void Resume();
sl@0: 
sl@0: private:
sl@0: 	/**
sl@0: 		@fn				CIdleScanningTimer(CDiscoverer& aDiscoverer)
sl@0: 		Intended Usage	: Standardised default c'tor made explicit to avoid unintentional
sl@0: 						conversion construction by the compiler.	
sl@0: 		Error Condition	: None	
sl@0: 		@since			7.0
sl@0: 		@param			aDiscoverer A reference to its owning class instance.
sl@0: 		@pre 			None
sl@0: 		@post			CIdleScanningTimer is fully constructed
sl@0: 	 */
sl@0: 	explicit CIdleScanningTimer(CDiscoverer& aDiscoverer);
sl@0: 	/**
sl@0: 		@fn				void ConstructL()
sl@0: 		Intended Usage	: Standardised 2nd, (Initialisation) phase of two phase construction.
sl@0: 		Error Condition	: Leaves with error code : usually KErrNoMemory.
sl@0: 		@leave  		KErrNoMemory.
sl@0: 		@since			7.0
sl@0: 		@return			void 
sl@0: 		@pre 			CIdleScanningTimer is fully constructed.
sl@0: 		@post			CIdleScanningTimer is fully initialised.
sl@0: 	 */
sl@0: 	void ConstructL();
sl@0: 
sl@0: 	/**
sl@0: 		@fn				DoCancel()
sl@0: 		Intended Usage	: The cancel action called by CActive::Cancel(). 
sl@0: 		Error Condition	: None	
sl@0: 		@since			7.0
sl@0: 		@pre 			CIdleScanningTimer is fully constructed.
sl@0: 		@post			CIdleScanningTimer is no longer active on the current scheduler.
sl@0: 	 */
sl@0: 	void DoCancel();
sl@0: 
sl@0: 	/**
sl@0: 		@fn				RunL()
sl@0: 		Intended Usage	: When the object activates, this method calls
sl@0: 						the CDiscoverer to continue the incremental scan 
sl@0: 						of the Interface Implementation Collection directories. 
sl@0: 		Error Condition	: Not enough memory available to add to complete the scan.
sl@0: 		@leave  		KErrNoMemory
sl@0: 		@since			7.0
sl@0: 		@pre 			CIdleScanningTimer is fully constructed.
sl@0: 		@post			The Interface Implementation Collection directories Scan has completed another step and the
sl@0: 						CIdleScanningTimer has been re-activated for the next step
sl@0: 						OR The Interface Implementation Collection directories Scan is complete and the 
sl@0: 						CDirChangeNotifier has been re-activated.
sl@0: 	 */
sl@0: 	void RunL();
sl@0: 
sl@0: 	/**
sl@0: 		@fn				RunError(TInt aError)
sl@0: 		Intended Usage	: Called when the directory change
sl@0: 						notification processing failed by leaving.
sl@0: 		@since			7.0
sl@0: 		@param			aError The error code that the RunL left with.
sl@0: 		@return			TInt KErrNone. 
sl@0: 		@pre 			CIdleScanningTimer is fully constructed.
sl@0: 		@post			CIdleScanningTimer is non-active.
sl@0: 	 */
sl@0: 	TInt RunError(TInt aError);
sl@0: 
sl@0: private:
sl@0: 	/** A reference to its owning class instance */
sl@0: 	CDiscoverer& iDiscoverer;	
sl@0: 
sl@0: 	/** 
sl@0: 		An array of drives to be processed.
sl@0: 	*/
sl@0: 	RArray<TUint> iPendingDriveList;
sl@0: 	
sl@0: 	/**
sl@0: 		A flag to indicate if the timer is suspended or not.
sl@0: 	*/
sl@0: 	TBool iSuspended;
sl@0: 
sl@0: 	// List the internal classes as friends
sl@0: 	// the Test bed state accessor
sl@0: 	friend class TDiscoverer_StateAccessor;
sl@0: 	};
sl@0: 
sl@0: 
sl@0: 
sl@0: /**
sl@0: 	CDirScanner implements incremental scanning of the Interface Implementation 
sl@0: 	Collection directories on behalf of the CDiscoverer.
sl@0: 	Its methods are called in response to the timer task execution,
sl@0: 	thereby requiring the incremental scheduling.
sl@0:  */ 
sl@0: class CDiscoverer::CDirScanner : public CBase
sl@0: 	{
sl@0: // Methods
sl@0: public:
sl@0: 	/**
sl@0: 		@fn				CDirScanner(CDiscoverer& aDiscoverer, RFs& aFs)
sl@0: 		Intended Usage	: Standardised safe construction which leaves nothing
sl@0: 						  on the cleanup stack.
sl@0: 		Error Condition	: Not enough memory available.	
sl@0: 		@leave  		KErrNoMemory
sl@0: 		@since			7.0
sl@0: 		@param			aDiscoverer A reference to its owning class instance.
sl@0: 		@param			aFs A reference to a connected file server instance.
sl@0: 		@return			CDirScanner* a pointer to the new class
sl@0: 		@pre 			None
sl@0: 		@post			CDirScanner is fully constructed, and initialised.
sl@0: 	 */
sl@0: 	static CDirScanner* NewL(CDiscoverer& aDiscoverer, RFs& aFs);
sl@0: 
sl@0: 	/**
sl@0: 		@fn				virtual ~CDirScanner()
sl@0: 		Intended Usage	: Standard default d'tor	
sl@0: 		Error Condition	: None	
sl@0: 		@since			7.0
sl@0: 		@pre 			CDirScanner is fully constructed.
sl@0: 		@post			CDirScanner is totally destroyed
sl@0: 	 */
sl@0: 	virtual ~CDirScanner();
sl@0: 
sl@0: 	
sl@0: 	/**
sl@0: 		@fn				DiscoverPluginsL()
sl@0: 		Intended Usage	: Discover the plugins the specific drive units.
sl@0: 		@param			: aIsRO a flag to show if the Drive Units list is RO Internal or not.
sl@0: 		@pre 			: CDiscoverer is fully constructed.iDirScanner is fully constructed.
sl@0: 		@pre			: CDirScanner is fully constructed.
sl@0: 		@post			: the plugins on the specific Drive Units have been discovered.
sl@0: 	 */
sl@0: 	 void DiscoverPluginsL(TBool aDiscoverReadOnlyDrives);
sl@0: 
sl@0: 	/**
sl@0: 		@fn				ScanDriveL(TDriveUnit aDrive)
sl@0: 		Intended Usage	: Helper method for StartScanL.
sl@0: 						Scan a drive for the Interface Implementation Collection directories
sl@0: 						and identify any Interface Implementation 
sl@0: 						Collections within that directory
sl@0: 						for addition to the registry. 
sl@0: 		Error Condition	: None	
sl@0: 		@leave  		KErrNoMemory
sl@0: 		@since			7.0
sl@0: 		@param			aDrive The drive to scan.
sl@0: 		@param			aIsRO A flag to tell if the drive unit is RO or Non-RO
sl@0: 		@pre 			CDirScanner is fully constructed.
sl@0: 		@post			Another drive's Interface Implementation Collection directories has been scanned,
sl@0: 	 */
sl@0: 	void ScanDriveL(const TDriveUnit& aDrive,  TBool aIsRO);
sl@0: 
sl@0: private:
sl@0: 	/**
sl@0: 		@fn				CDirScanner(CDiscoverer& aDiscoverer, RFs& aFs)
sl@0: 		Intended Usage	: Standardised default c'tor. 
sl@0: 		Error Condition	: None	
sl@0: 		@since			7.0
sl@0: 		@param			aDiscoverer A reference to its owning class instance.
sl@0: 		@param			aFs A reference to a connected file server instance.
sl@0: 		@pre 			None
sl@0: 		@post			CDirScanner is fully constructed
sl@0: 	 */
sl@0: 	CDirScanner(CDiscoverer& aDiscoverer, RFs& aFs);
sl@0: 
sl@0: 	/**
sl@0: 		@fn				void ConstructL()
sl@0: 		Intended Usage	: Standardised 2nd, (Initialisation) phase of two phase construction.
sl@0: 		Error Condition	: Leaves with error code : usually KErrNoMemory.
sl@0: 		@leave  		KErrNoMemory.
sl@0: 		@since			7.0
sl@0: 		@return			void 
sl@0: 		@pre 			CDirScanner is fully constructed.
sl@0: 		@post			CDirScanner is fully initialised.
sl@0: 	 */
sl@0: 	void ConstructL();
sl@0: 
sl@0: 
sl@0: 
sl@0: 	/**
sl@0: 		@fn				DoScanDriveL(const TDriveUnit aDrive, const TUidType aUidType)
sl@0: 		Intended Usage	: Helper method for StartScanL.
sl@0: 						Scan a drive for the Interface Implementation Collection directories
sl@0: 						and identify any Interface Implementation 
sl@0: 						Collections within that directory
sl@0: 						for addition to the registry. 
sl@0: 		Error Condition	: None	
sl@0: 		@leave  		KErrNoMemory
sl@0: 		@since			9.0
sl@0: 		@param			aDrive The drive to scan.
sl@0: 		@param			aUidType The uid type to be searched for.
sl@0: 		@param			aIsRO Indicates whether the current drive is read Only.
sl@0: 		@pre 			CDirScanner is fully constructed.
sl@0: 		@post			Another drive's Interface Implementation Collection directories has been scanned,
sl@0: 	 */
sl@0: 	TBool DoScanDriveL(const TDriveUnit& aDrive, const TUidType& aUidType, TBool aIsRO);
sl@0: 
sl@0: 	/**
sl@0: 		@fn				DoScanSpiFileL(const TParse aSpiPath)
sl@0: 		Intended Usage	: Helper method for StartScanL.
sl@0: 						Scan a SPI file for the Interface Implementation Collection directories
sl@0: 						and identify any Interface Implementation Collections within that directory
sl@0: 						for addition to the registry. 
sl@0: 		Error Condition	: None	
sl@0: 		@leave  		KErrNoMemory
sl@0: 		@since			9.0
sl@0: 		@param			aSpiPath The SPI file to scan.
sl@0: 		@pre 			CDirScanner is fully constructed.
sl@0: 		@post			Another drive's Interface Implementation Collection has been scanned from an SPI file.
sl@0: 	 */
sl@0: 	TBool DoScanSpiFileL(const TParse& aSpiPath);
sl@0: 
sl@0: 	
sl@0: // Attributes / Properties
sl@0: private:
sl@0: 	/** A reference to its owning class instance */
sl@0: 	CDiscoverer& iDiscoverer;	
sl@0: 	/** A reference to a connected file server instance */
sl@0: 	RFs&	iFs;
sl@0: 	/** The Full Interface Implementation Collection Directory path */
sl@0: 	
sl@0: 	// List the internal classes as friends
sl@0: 	// the Test bed state accessor
sl@0: 	friend class TDiscoverer_StateAccessor;
sl@0: 
sl@0: 
sl@0: };  // CDirScanner
sl@0: 
sl@0: #endif // __DISCOVERER_H__
sl@0: