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