--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/installationservices/swi/source/securitymanager/certificateretriever.h	Thu Dec 17 08:51:10 2009 +0200
@@ -0,0 +1,125 @@
+/*
+* Copyright (c) 2004-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
+ @released
+ @internalTechnology
+*/
+
+#ifndef __CERTIFICATERETRIEVER_H__
+#define __CERTIFICATERETRIEVER_H__
+
+#include <e32base.h>
+#include <ct/rmpointerarray.h>
+
+class CCTCertInfo;
+class CCertAttributeFilter;
+class CSWICertStore;
+
+namespace Swi
+{
+
+/**
+ * This is an helper class for the Security Manager. Given a back end
+ * certstore it retrieves the mandatory certificates it contains.
+ *
+ */
+class CCertificateRetriever : public CActive
+{
+ public:
+
+	/**
+	 * Creates a CCertificateRetriever with access to the specified
+	 * certstore. 
+	 *
+	 * @param aCerstore The certstore from where this class will retrieve
+	 *                  certificates
+	 * @return a new certificate retriever
+	 */
+ 	static CCertificateRetriever* NewL(CSWICertStore& aCerstore);
+
+	/**
+	 * Creates a CCertificateRetriever with access to the specified
+	 * certstore and leaves it on the cleanup stack.	
+	 *
+	 * @param aCerstore The certstore from where this class will retrieve
+	 *                  certificates
+	 * @return A new certificate retriever
+	 */
+  	static CCertificateRetriever* NewLC(CSWICertStore& aCerstore);
+
+  	~CCertificateRetriever();
+
+ public:
+
+	/**
+	 * This method will retrieve all self-signed (CA) certificates present
+	 * in the back-end certstore it represents
+	 *
+	 * @param aCertificateListOut An output parameter which contains the mandatory 
+	 *                            certificates retrieved
+	 * @param aClientStatus       The client request status.
+	 */ 
+
+	void RetrieveCACertificates(RMPointerArray<CCTCertInfo>& aCertificateListOut, TRequestStatus& aClientStatus);
+	
+
+public: // from CActive 
+	void RunL();
+	void DoCancel();
+	TInt RunError(TInt aError);	
+		
+private:
+	CCertificateRetriever(CSWICertStore& aCerstore);
+	void ConstructL();
+	void DoInitialize(RMPointerArray<CCTCertInfo>& aCertificateListOut, TRequestStatus& aClientStatus);
+
+private:
+
+	/**
+	 * The client request status. 
+	 */
+	TRequestStatus* iClientStatus;
+
+	/** 
+	 * The DN of the certificates retrieved. It can be empty
+	 * if there are not mandatory ones. The class does <b>not</b> own this.
+	 */
+	RMPointerArray<CCTCertInfo>* iCertificateList; 
+
+	/**
+	 * The underlying certstore backend. The certificates come from here.
+	 */
+	CSWICertStore& iCertStore; 
+	
+	/**
+	 * A filter used to get relevant certificates from the certstore.
+	 * In our case we are interested only in CA certificate.
+	 */
+	CCertAttributeFilter* iFilter; 
+	
+    enum TCertRetrieverState
+	   {
+	   EBuildCAList
+       } iState;	
+};
+
+} // namespace SWI
+
+#endif // __CERTIFICATERETRIEVER_H__