/*

 * 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__