/*

* Copyright (c) 2006-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: 

* CryptoSpi Utility Functionality definition

*

*/

/**

 @file

 @internalComponent

 @released

*/

#ifndef __CRYPTOSPIUTIL_H__

#define __CRYPTOSPIUTIL_H__

#include <cryptospi/cryptocharacteristics.h>

#include <cryptospi/ruleselector.h>

namespace CryptoSpi

	{

	class CryptoSpiUtil

		{

	public:

		/**

		Run the cryptospi setup executable to publish the characteristics

		@return KErrNone if successful; otherwise, a system wide error code.

		*/

		static TInt RunCryptoSpiPropertySetupExe();

		/**

		Retrieve characteristics and Dll list for an interface

		@param aInterface the interface Uid

		*/

		static void RetrieveCharacteristicsL(TInt32 aInterface, RPointerArray<CCharacteristicsAndPluginName>& aList);

		/**

		Retrieve characteristics and Dll list for an interface

		@param aInterface the interface Uid

		*/

		static void RetrieveCharacteristicsL(TInt32 aInterface, RPointerArray<CRulesCharacteristicsAndPluginName>& aList);

		/**

		Get the plugin dll name from the given Dll index

		@param aDllIndex dll index

		@param aName the plugin file name

		@return KErrNone if successful; otherwise, a system wide error code.

		*/

		static TInt DllIndexToName(TInt aDllIndex, TFileName& aName);

		/**

		Load the given name plugin Dll, and leaves the plugin handle on the cleanup stack

		@param aLib the library handle of the plugin dll, which is put on the cleanup stack.

		@param aFileName the plugin dll file name

		*/

		static void LoadPluginDllLC(RLibrary& aLib, TFileName& aFileName);

		/**

		Create the characteristics for a crypto interface

		@param aInterface the crypto interface

		@return the pointer to characteristic

		*/

		static CCharacteristics* CreateCharacteristicsL(TInt32 aInterface);

	private:

		/**

		Retrieve the characteristics to the given buffer

		@param aInterface the crypto interface

		@param aStream the steam to read from

		@param aBuf the buffer which holds the characteristic

		@param aCount the count of the characteristics.

		*/	

		static TInt RetrieveCharacteristicsL(TInt32 aInterface, RDesReadStream& aStream, RBuf8& aBuf, TInt& aCount);

		};

	}

#endif //__CRYPTOSPIUTIL_H__