// Copyright (c) 1995-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:

// f32\sfsrv\cl_plugin.cpp

// 

//

#include "cl_std.h"

EXPORT_C TInt RFs::AddPlugin(const TDesC& aFileName) const

/**

@internalTechnology

Loads a specified Plugin.

@param aFileName The file name of the plugin

@return KErrNone, if successful; otherwise one of the other system wide error codes.

@capability DiskAdmin

*/

	{

	RLoader loader;

	TInt r = loader.Connect();

	if (r==KErrNone)

		{

		r = loader.SendReceive(ELoadFSPlugin, TIpcArgs(0, &aFileName, 0));

		loader.Close();

		}

	return r;

	}

EXPORT_C TInt RFs::RemovePlugin(const TDesC& aPluginName) const

/**

@internalTechnology

Removes the specified plugin.

@param aPluginName The full name of the plugin to be removed.

@return KErrNone, if successful;

        KErrNotFound, if aPluginName is not found;

        otrherwise one of the other system-wide error codes.

@capability DiskAdmin

*/

	{

	TInt r = SendReceive(EFsRemovePlugin,TIpcArgs(&aPluginName));

	return r;

	}

EXPORT_C TInt RFs::MountPlugin(const TDesC& aPluginName) const

/**

@internalTechnology

Mounts a specified plugin. 

Note that this API uses unique position of the plugin.

This overload passes KPluginAutoAttach for the drive parameter

which mounts on all of the drives specified as supported by the plugin.

Note - Plugins cannot be mounted on demand paged drives.

KErrNone is returned so long as it has been able to mount on 

at least one drive; otherwise KErrNotSupported.

@param aPluginName		The fullname of the plugin, as returned from

							a call to PluginName().

@return KErrNone if successful;

        KErrNotFound, if the plugin cannot be found;

        otherwise one of the other system-wide error codes.

@see RFs::PluginName  

@capability DiskAdmin      

*/

	{

	TInt r = SendReceive(EFsMountPlugin,TIpcArgs(&aPluginName,KPluginAutoAttach,KPluginAutoLocate));

	return r;

	}

EXPORT_C TInt RFs::MountPlugin(const TDesC& aPluginName,TInt aDrive) const

/**

@internalTechnology

Mounts a specified plugin specifying the drive plugin will support.

@param aPluginName		The fullname of the plugin, as returned from

							a call to PluginName().

@param aDrive			If the mounted plugin is a version2 plugin, then in order to

						mount on drive z, KPluginMountDriveZ should be passed as a parameter.

						For all other drive letters use values 0 to 24 for A to Y.

						Version1 plugins cannot mount on Z drive.

						To let the plugin decide on which drives to mount, use KPluginAutoAttach.

						Plugins cannot be mounted on demand paged drives. If KPluginAutoAttach is passed

						in, it will return KErrNone so long as it has been able to mount on at 

						least one drive; otherwise KErrNotSupported.

@return KErrNone if successful;

        KErrNotFound, if the plugin cannot be found;

        otherwise one of the other system-wide error codes.

@see RFs::PluginName 

@capability DiskAdmin      

*/

	{

	TInt r = SendReceive(EFsMountPlugin,TIpcArgs(&aPluginName,aDrive,KPluginAutoLocate));

	return r;

	}

EXPORT_C TInt RFs::MountPlugin(const TDesC& aPluginName,TInt aDrive, TInt aPos) const

/**

@internalTechnology

Mounts a specified plugin using absolute position and a specific drive  

@param aPluginName		The fullname of the plugin, as returned from

							a call to PluginName().

@param aDrive			If the mounted plugin is a version2 plugin, then in order to

						mount on drive z, KPluginMountDriveZ should be passed as a parameter.

						For all other drive letters use values 0 to 24 for A to Y.

						Version1 plugins cannot mount on Z drive.

						To let the plugin decide on which drives to mount, use KPluginAutoAttach.

						Plugins cannot be mounted on demand paged drives. If KPluginAutoAttach is passed

						in, it will return KErrNone so long as it has been able to mount on at 

						least one drive; otherwise KErrNotSupported.

@param aPos				The position at which the plugin is to be mounted within the internal array of plugins.

							Plugins wishing to be mounted using their CFsPlugin::iUniquePos 

							should use MountPlugin(TDesC&,TInt) or MountPlugin(TDesC&)

							If there is already a plugin at aPos then this plugin is inserted 

							into aPos and other plugins are shifted downwards.

@return KErrNone if successful;

        KErrNotFound, if the plugin cannot be found;

        otherwise one of the other system-wide error codes.

@see RFs::PluginName 

@see RFs::MountPlugin(const TDesC& aPluginName,TInt aDrive)

@capability DiskAdmin        

*/

	{

	TInt r = SendReceive(EFsMountPlugin,TIpcArgs(&aPluginName,aDrive,aPos));

	return r;

	}

EXPORT_C TInt RFs::DismountPlugin(const TDesC& aPluginName) const

/**

@internalTechnology

Dismounts the specified plugin from all drives on which it is mounted.

@param aPluginName  The fullname of the plugin, as returned from

                       a call to PluginName().

@return KErrNone if successful;

        KErrNotFound, if the plugin cannot be found;

        otherwise one of the other system-wide error codes.

@see RFs::PluginName  

@capability DiskAdmin       

*/

	{

	TInt r = SendReceive(EFsDismountPlugin,TIpcArgs(&aPluginName,KPluginAutoAttach,KPluginAutoLocate));

	return r;

	}

EXPORT_C TInt RFs::DismountPlugin(const TDesC& aPluginName,TInt aDrive) const

/**

@internalTechnology

Dismounts the specified plugin.

@param aPluginName		The fullname of the plugin, as returned from

							a call to PluginName().

@param aDrive			The drive on which the plugin is to be dismounted;

						If the mounted plugin is a version2 plugin, then in order to

						dismount drive z, KPluginMountDriveZ should be passed as a parameter.

						For all other drive letters use values 0 to 24 for A to Y.

						Version1 plugins cannot mount on Z drive.

@return KErrNone if successful;

        KErrNotFound, if the plugin cannot be found;

        otherwise one of the other system-wide error codes.

@see RFs::PluginName  

@capability DiskAdmin       

*/

	{

	TInt r = SendReceive(EFsDismountPlugin,TIpcArgs(&aPluginName,aDrive,KPluginAutoLocate));

	return r;

	}

EXPORT_C TInt RFs::DismountPlugin(const TDesC& aPluginName,TInt aDrive,TInt aPos) const

/**

@internalTechnology

Dismounts the specified plugin.

@param aPluginName		The fullname of the plugin, as returned from

							a call to PluginName().

@param aDrive			If the mounted plugin is a version2 plugin, then in order to

						dismount drive z, KPluginMountDriveZ should be passed as a parameter.

						For all other drive letters use values 0 to 24 for A to Y.

						Version1 plugins cannot mount on Z drive.

@param aPos				The position at which the plugin is located in the internal

							array of plugins.

						To automatically locate the position of the plugin use 

							DismountPlugin::(TDesC&,TInt) or

							DismountPlugin::(TDesC&)

@return KErrNone if successful;

        KErrNotFound, if the plugin cannot be found;

        otherwise one of the other system-wide error codes.

@see RFs::PluginName   

@capability DiskAdmin      

*/

	{

	TInt r = SendReceive(EFsDismountPlugin,TIpcArgs(&aPluginName,aDrive,aPos));

	return r;

	}

EXPORT_C TInt RFs::PluginName(TDes& aPluginName,TInt aDrive,TInt aPos)

/**

@internalTechnology

Gets the name of the plugin on the specified drive at the specified position

in the plugin hierarchy.

@param aPluginName		On successful return, contains the name of the plugin.

@param aDrive			The drive for which the plugin name is required.

@param aPos				The position of the plugin in the plugin hierarchy.

@return KErrNone, if successful;

        KErrNotFound if the plugin name is not found;

*/

	{

	TInt r = SendReceive(EFsPluginName,TIpcArgs(&aPluginName,aDrive,aPos));

	return r;

	}

EXPORT_C TInt RPlugin::Open(RFs& aFs, TInt aPos)

/**

@internalTechnology

Opens a plugin for userside engine conn

@param	aFs: File server session 

@prama  aPos: Unique position of the plugin

@return KErrNotFound if it didn't find the plugin, else KErrNone

*/

	{

	TInt r = CreateSubSession(aFs,EFsPluginOpen,TIpcArgs(aPos,0,0));

	return r;

	}

EXPORT_C void RPlugin::Close()

/**

@internalTechnology

Closes a plugin 

*/

	{

	CloseSubSession(EFsPluginSubClose);

	}

EXPORT_C void RPlugin::DoRequest(TInt aReqNo, TRequestStatus& aStatus) const

/**

@internalTechnology

Client requests a asynchronous operation

@param aReqNo: Number of the request

@param aStatus: status of the request

*/

	{

	aStatus=KRequestPending;

	SendReceive(EFsPluginDoRequest, TIpcArgs(aReqNo, NULL, NULL), aStatus);

	}

EXPORT_C void RPlugin::DoRequest(TInt aReqNo, TRequestStatus& aStatus, TDes8& a1) const

/**

@internalTechnology

Client requests a asynchronous operation

@param aReqNo: Number of the request

@param aStatus: status of the request

@param a1: returning value from plugin

*/

	{

	aStatus=KRequestPending;

	SendReceive(EFsPluginDoRequest, TIpcArgs(aReqNo, &a1, NULL), aStatus);

	}

EXPORT_C void RPlugin::DoRequest(TInt aReqNo, TRequestStatus& aStatus, TDes8& a1, TDes8& a2) const

/**

@internalTechnology

@param aReqNo: Number of the request

@param aStatus: status of the request

@param a1: returning value from plugin

@param a2: 2nd returning value from plugin

*/

	{

	aStatus=KRequestPending;

	SendReceive(EFsPluginDoRequest, TIpcArgs(aReqNo, &a1, &a2), aStatus);

	}

EXPORT_C TInt RPlugin::DoControl(TInt aFunction) const

/**

@internalTechnology

Client requests a synchronous operation

@param	aFunction: The operation to be handled

*/

	{

	TInt r = SendReceive(EFsPluginDoControl,TIpcArgs(aFunction,0,0));

	return r;

	}

EXPORT_C TInt RPlugin::DoControl(TInt aFunction, TDes8& a1) const

/**

@internalTechnology

Client requests a synchronous operation

@param	aFunction: The operation to be handled

@param	a1: returned buffer from plugin on completion of the request

*/

	{

	TInt r = SendReceive(EFsPluginDoControl,TIpcArgs(aFunction,&a1,0));

	return r;

	}

EXPORT_C TInt RPlugin::DoControl(TInt aFunction, TDes8& a1, TDes8& a2) const

/**

@internalTechnology

Client requests a synchronous operation

@param	aFunction: The operation to be handled

@param	a1: returned buffer from plugin on completion of the request

@param  a2: 2nd returned buffer from plugin on completion of the request

*/

	{

	TInt r = SendReceive(EFsPluginDoControl,TIpcArgs(aFunction,&a1,&a2));

	return r;

	}

EXPORT_C void RPlugin::DoCancel(TUint aReqMask) const

/**

@internalTechnology

Cancels a request

@param	aReqMask: the bit mask for the operation to be cancelled

*/

	{

	SendReceive(EFsPluginDoCancel,TIpcArgs(KMaxTInt,aReqMask,0));

	}