/*

* Copyright (c) 2003-2007 Nokia Corporation and/or its subsidiary(-ies). 

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "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:   Wrapper class for Symbian's Security Framework's calls

*

*/

#ifndef     CERTMANUISYNCWRAPPER_H

#define     CERTMANUISYNCWRAPPER_H

// INCLUDES

#include <e32base.h>

// FORWARD DECLERATIONS

class CCertificate;

class CPKIXValidationResult;

class CPKIXCertChain;

class CUnifiedCertStore;

// CLASS DECLARATION

/**

*  Wrapper class for Symbian's Security Framework's calls.

*  Shows error notes if an error happenes.

*

*  @lib certmanui.dll

*  @since S60 2.0

*/

NONSHARABLE_CLASS( CCertManUISyncWrapper ): public CActive

    {

    public:

        /**

        * Two-phased constructor.

        */

        static CCertManUISyncWrapper* NewLC();

        /**

        * Two-phased constructor.

        */

        static CCertManUISyncWrapper* NewL();

        /**

        * Destructor.

        */

        ~CCertManUISyncWrapper();

    public: // New functions

        /**

        * TInt ListL

        * @since S60 2.8

        * @param aStore reference to store where operation is done.

        * @param aArray Keys are stored here.

        * @param aFilter Information on what kind keys are looked.

        * @return TInt Status Symbian's API's call.

        */

        TInt ListL( CUnifiedKeyStore*& aStore,

            RMPointerArray<CCTKeyInfo>* aArray,

            const TCTKeyAttributeFilter& aFilter );

        /**

        * TInt ListL

        * @since S60 3.2

        * @param aStore reference to store where operation is done.

        * @param aArray Keys are stored here.

        * @param aFilter Information on what kind keys are looked.

        * @param aTokenUid Token UID of key store

        * @return TInt Status Symbian's API's call.

        */

        TInt ListL( CUnifiedKeyStore*& aStore,

            RMPointerArray<CCTKeyInfo>* aArray,

            const TCTKeyAttributeFilter& aFilter,

            const TUid aTokenUid );

        /**

        * TInt ListL

        * @since S60 2.0

        * @param aStore reference to store where operation is done.

        * @param aArray certificates are stored here.

        * @param aFilter Information on what kind certificates are looked.

        * @return TInt Status Symbian's API's call.

        */

        TInt ListL( CUnifiedCertStore*& aStore,

            RMPointerArray<CCTCertInfo>* aArray,

            const CCertAttributeFilter& aFilter );

        /**

        * TInt ListL

        * @since S60 3.2

        * @param aStore reference to store where operation is done.

        * @param aArray certificates are stored here.

        * @param aFilter Information on what kind certificates are looked.

        * @param aTokenUid Token UID of certificate store

        * @return TInt Status Symbian's API's call.

        */

        TInt ListL( CUnifiedCertStore*& aStore,

            RMPointerArray<CCTCertInfo>* aArray,

            const CCertAttributeFilter& aFilter,

            const TUid aTokenUid );

        /**

        * TInt GetCertificateL

        * @since S60 2.0

        * @param aStore reference to store where operation is done.

        * @param aCertInfo Certificate that's detailed information is fetched.

        * @param aCert Fetched certificate.

        * @return TInt Status Symbian's API's call.

        */

        TInt GetCertificateL( CUnifiedCertStore*& aStore,

            const CCTCertInfo& aCertInfo, CCertificate*& aCert );

        /**

        * TInt GetCertificateL

        * @since S60 3.2

        * @param aStore reference to store where operation is done.

        * @param aCertInfo Certificate that's detailed information is fetched.

        * @param aCert Fetched certificate.

        * @return TInt Status Symbian's API's call.

        */

        TInt GetCertificateL( CUnifiedCertStore*& aStore,

            const CCTCertInfo& aCertInfo, CCertificate*& aCert, TUid aTokenUid );

        /**

        * TInt GetUrlCertificateL

        * @since S60 3.0

        * @param aStore reference to store where operation is done.

        * @param aCertInfo Certificate that's detailed information is fetched.

        * @param aUrl Fetched URL.

        * @return TInt Status Symbian's API's call.

        */

        TInt GetUrlCertificateL(

            CUnifiedCertStore*& aStore,

            const CCTCertInfo& aCertInfo,

            TDes8& aUrl)            ;

        /**

        * TInt GetApplicationsL

        * @since S60 2.0

        * @param aStore reference to store where operation is done.

        * @param aCertInfo Certificate that applications are fetched.

        * @param Certificates applications are stoted here.

        * @return TInt Status Symbian's API's call.

        */

        TInt GetApplicationsL( CUnifiedCertStore*& aStore,

            const CCTCertInfo& aCertInfo, RArray<TUid>& aApps );

        /**

        * TInt ValidateX509RootCertificateL

        * @since S60 2.0

        * @param aValidationResult Result of validation.

        * @param aValidationTime Time of validation.

        * @param aChain Chain to be validated.

        * @return TInt Status Symbian's API's call.

        */

        TInt ValidateX509RootCertificateL(

            CPKIXValidationResult*& aValidationResult,

            const TTime& aValidationTime, CPKIXCertChain* aChain );

        /**

        * TInt InitStoreL

        * @since S60 2.0

        * @param aStore reference to store to be initialized.

        * @return TInt Status Symbian's API's call.

        */

        TInt InitStoreL( CUnifiedCertStore*& aStore );

        /**

        * void InitStoreL

        * @since S60 2.8

        * @param aStore reference to store to be initialized.

        * @return TInt Status Symbian's API's call.

        */

        TInt InitStoreL( CUnifiedKeyStore*& aStore );

        /**

        * TInt DeleteCertL

        * @since S60 2.0

        * @param aStore reference to store where operation is done.

        * @param aCertInfo Certificate to be deleted.

        * @return TInt Status Symbian's API's call.

        */

        TInt DeleteCertL( CUnifiedCertStore*& aStore,

            const CCTCertInfo& aCertInfo );

        /**

        * TInt DeleteCertL

        * @since S60 3.2

        * @param aStore reference to store where operation is done.

        * @param aCertInfo Certificate to be deleted.

        * @return TInt Status Symbian's API's call.

        */

        TInt DeleteCertL( CUnifiedCertStore*& aStore,

            const CCTCertInfo& aCertInfo,

            TUid aTokenUid );

        /**

        * TInt IsApplicableL

        * @since S60 2.0

        * @param aStore reference to store where operation is done.

        * @param aCertInfo Certificate thats applicability is queried.

        * @param aApplication Application that's status is queried.

        * @param aIsApplicable ETrue if applcable.

        * @return TInt Status Symbian's API's call.

        */

        TInt IsApplicableL( CUnifiedCertStore*& aStore,

            const CCTCertInfo& aCertInfo, TUid aApplication,

        TBool& aIsApplicable );

        /**

        * TInt IsTrustedL

        * @since S60 2.0

        * @param aStore reference to store where operation is done.

        * @param aCertInfo Certificate that's trust status is queried.

        * @param aTrusted ETrue if trusted.

        * @return TInt Status Symbian's API's call.

        */

        TInt IsTrustedL( CUnifiedCertStore*& aStore,

            const CCTCertInfo& aCertInfo, TBool& aTrusted );

        /**

        * TInt SetApplicabilityL

        * @since S60 2.0

        * @param aStore reference to store where operation is done.

        * @param aCertInfo Certificate thats applicability is set.

        * @param aApplications New applicability settings.

        * @return TInt Status Symbian's API's call.

        */

        TInt SetApplicabilityL( CUnifiedCertStore*& aStore,

            const CCTCertInfo& aCertInfo,

        RArray<TUid>& aApplications );

      /**

        * void MoveCertL

        * @since S60 3.2

        * @param aStore reference to store where operation is done

        * @param aCertInfo Certificate info

        * @param aSourceStore UID of source certificate store

        * @param aTargetStore UID of source certificate store

        * @return TInt Number of moved certificates

        */

        TInt MoveCertL( CUnifiedCertStore*& aStore,

            const CCTCertInfo& aCertInfo,

            const TUid aSourceTokenId,

            const TUid aTargetTokenId );

      /**

        * void MoveKeyL

        * @since S60 3.2

        * @param aStore reference to store where operation is done

        * @param CCTKeyInfo Key info

        * @param aSourceStore UID of source key store

        * @param aTargetStore UID of source key store

        * @return none

        */

        void MoveKeyL( CUnifiedKeyStore*& aStore,

            const TCTKeyAttributeFilter& aFilter,

            const TUid aSourceTokenId,

            const TUid aTargetTokenId );

        /**

        * TInt GetInterface

        * @since S60 3.0

        * @param aToken reference to token

        * @param aTokenInterface Pointer to returned interface

        * @return TInt Status Symbian's API's call.

        */

        TInt GetInterface( TUid aRequiredInterface,

            MCTToken& aToken,

            MCTTokenInterface*& aReturnedInterface );

    protected:

        void DoCancel();

        void RunL();

    private:

        CCertManUISyncWrapper();

        void ConstructL();

        void HandleErrorL();

    private:    //Data

        // Internal operation states.

        enum TOperation

            {

            EOperationNone,

            EOperationInit,

            EOperationList,

            EGetCertificate,

            EAddCertificate,

            ERetriveURLCertificate,

            EOperationDelete,

            EOperationGetApps,

            EOperationIsApplicable,

            EOperationIsTrusted,

            EOperationSetApplicability,

            EOperationSetToTrusted,

            EOperationValidateX509Root,

            EShowErrorNote,

            EOperationInitKeyStore,

            EOperationKeyList,

            EOperationGetInterface,

            EOperationExportKey,

            EOperationImportKey,

            EOperationDeleteKey

            };

        // For wrapping asynchronous calls.

        CActiveSchedulerWait    iWait;

        // Internal state of operation.

        TOperation              iOperation;

        // Just for cancelling a operation. Does not own.

        CUnifiedCertStore*      iStore;

        // Just for cancelling a operation. Does not own.

        CUnifiedKeyStore*       iKeyStore;

        // Just for cancelling a operation. Does not own.

        CPKIXCertChain*         iChain;

        // For retrieving a certificate.

        TPtr8                   iCertPtr;

        // Token handle

        MCTToken*               iToken;

    };

#endif // CERTMANUISYNCWRAPPER_H

// End of File