/*

* Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

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

* which accompanies this distribution, and is available

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

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description: 

*

*/

/**

 @file

 @publishedPartner

 @released

*/

#ifndef SWI_DAEMON_PLUGIN_H

#define SWI_DAEMON_PLUGIN_H

#include <ecom/ecom.h>

class CSwiDaemonPlugin : public CBase

	{

public:

	static CSwiDaemonPlugin *NewL();

	/**

	 * Media has been inserted with one, or more, valid (ie. correct

	 * header), uninstalled, stub-SIS files on it. This will be

	 * followed by one or more calls to RequestInstall for each SIS

	 * file on this media.

	 *

	 * @param aDrive Drive being processed

	 */

	virtual void MediaProcessingStart( TInt aDrive ) = 0;

	/**

	 * @param aFile - RFile handle, valid until this function returns.

	 *

	 * The FS associated with the RHandle is marked for sharing (so

	 * the RHandle can be passed to a server using

	 * RFile::TransferToServer).

	 * 

	 * Note that immediately after this call, the RFile handle will be

	 * closed. This means that the plugin must either duplicate it, or

	 * synchronously send it to a server which adopts it before this

	 * function returns.

	 */

	virtual void RequestInstall( RFile& aFile ) = 0;

	/**

	 * Normally a sequence of RequestInstall calls for each SIS file

	 * on a media will be followed by a call to this function.

	 *

	 * Alternatively MediaRemoved might be called to abort the sequence.

	 */

	virtual void MediaProcessingComplete() = 0; 

	/**

	 * Media has been removed from drive.

	 *

	 * @param aDrive Drive number

	 *

	 * If the media in the drive specified by the last call to

	 * MediaProcessingStart is removed, then this function will be

	 * called, regardless of whether or not MediaProcessingComplete

	 * has been called.

	 *

	 * This function may also be called when media is removed from any

	 * drive.

	 */

	virtual void MediaRemoved( TInt aDrive ) = 0;

	virtual ~CSwiDaemonPlugin();

private:

	TUid iDtor_ID_Key;

	};

_LIT8(KX,"X");

inline CSwiDaemonPlugin *CSwiDaemonPlugin::NewL()

	{

	const TUid KSwiDriveWatcherPlugin = { 0x10274D07 };

	TEComResolverParams resolverParams;

	resolverParams.SetDataType(KX());

	TAny *ptr = REComSession::CreateImplementationL(KSwiDriveWatcherPlugin,

													_FOFF(CSwiDaemonPlugin, iDtor_ID_Key),

													resolverParams,

													KRomOnlyResolverUid);

	return (CSwiDaemonPlugin *)ptr;

	}

inline CSwiDaemonPlugin::~CSwiDaemonPlugin()

	{

	REComSession::DestroyedImplementation(iDtor_ID_Key);

	}

#endif // SWI_DRIVEWATCHER_PLUGIN_H