/*
* Copyright (c) 2004 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:  ?Description
*
*/



#ifndef CCMSKeyTransRecipientInfo_H
#define CCMSKeyTransRecipientInfo_H

#include "CCMSRecipientInfo.h"

// FORWARD DECLARATION
class CCMSIssuerAndSerialNumber;

// CONSTANTS
const TInt KCMSKeyTransRecipientInfoIssuerAndSerialNumberVersion = 0;
const TInt KCMSKeyTransRecipientInfoSubjectKeyIdentifierVersion = 2;

// CLASS DECLARATION
/**
*  KeyTransRecipientInfo type module
*
*  ASN.1 definition:
*    KeyTransRecipientInfo ::= SEQUENCE {
*        version CMSVersion,  -- always set to 0 or 2
*        rid RecipientIdentifier,
*        keyEncryptionAlgorithm KeyEncryptionAlgorithmIdentifier,
*        encryptedKey EncryptedKey }
*
*    RecipientIdentifier ::= CHOICE {
*        issuerAndSerialNumber IssuerAndSerialNumber,
*        subjectKeyIdentifier [0] SubjectKeyIdentifier }
*
*  @lib cms.lib
*  @since 2.8
*/
class CCMSKeyTransRecipientInfo : public CCMSRecipientInfo
    {
    public:  // Constructors and destructor
		/**
        * Two-phased constructor. Leaves the object in cleanup stack.
        */
        IMPORT_C static CCMSKeyTransRecipientInfo* NewLC();

        /**
        * Two-phased constructor.
        */
        IMPORT_C static CCMSKeyTransRecipientInfo* NewL();

        /**
        * Two-phased constructor. Copies of the parameters are made.
        *
        * @param aIssuerAndSerialNumber rid (RecipientIdentifier) value
        * @param aKeyEncryptionAlgorithm KeyEncryptionAlgorithmIdentifier
        * @param aEncryptedKey EncryptedKey value
        */
        IMPORT_C static CCMSKeyTransRecipientInfo* NewL(
            const CCMSIssuerAndSerialNumber& aIssuerAndSerialNumber,
            const CCMSX509AlgorithmIdentifier& aKeyEncryptionAlgorithm,
            const TDesC8& aEncryptedKey );

        /**
        * Two-phased constructor. Copies of the parameters are made.
        * Leaves the object in cleanup stack.
        *
        * @param aSubjectKeyIdentifier rid (RecipientIdentifier) value
        * @param aKeyEncryptionAlgorithm KeyEncryptionAlgorithmIdentifier
        * @param aEncryptedKey EncryptedKey value
        */
        IMPORT_C static CCMSKeyTransRecipientInfo* NewLC(
            const TDesC8& aSubjectKeyIdentifier,
            const CCMSX509AlgorithmIdentifier& aKeyEncryptionAlgorithm,
            const TDesC8& aEncryptedKey );
        
        /**
        * Two-phased constructor. Copies of the parameters are made.
        *
        * @param aSubjectKeyIdentifier rid (RecipientIdentifier) value
        * @param aKeyEncryptionAlgorithm KeyEncryptionAlgorithmIdentifier
        * @param aEncryptedKey EncryptedKey value
        */
        IMPORT_C static CCMSKeyTransRecipientInfo* NewL(
            const TDesC8& aSubjectKeyIdentifier,
            const CCMSX509AlgorithmIdentifier& aKeyEncryptionAlgorithm,
            const TDesC8& aEncryptedKey );


        /**
        * Destructor.
        */
        virtual ~CCMSKeyTransRecipientInfo();

    public: // New functions
        /**
        * Getter for EncryptedKey
        * @since 2.8
        * @return EncryptedKey
        */
		IMPORT_C const TDesC8& EncryptedKey() const;

        /**
        * Getter for IssuerAndSerialNumber. Ownership is not transferred.
        * @since 2,8
        * @return IssuerAndSerialNumber or NULL if rid is not
        * IssuerAndSerialNumber
        */
		IMPORT_C const CCMSIssuerAndSerialNumber* IssuerAndSerialNumber() const;

        /**
        * Getter for subjectKeyIdentifier. Ownership is not transferred.
        * @since 2,8
        * @return subjectKeyIdentifier or NULL if rid is not
        * subjectKeyIdentifier.
        */
		IMPORT_C const TDesC8* SubjectKeyIdentifier() const;

		/**
        * Setter for EncryptedKey. Creates a copy of the parameters.
        * @since 2.8
        * @param aEncryptedKey EncryptedKey value.
        */
		IMPORT_C void SetEncryptedKeyL(
            const TDesC8& aEncryptedKey );

		/**
        * Setter for IssuerAndSerialNumber. Creates a copy of the parameters.
        * Note that any existing subjectKeyIdentifier value is
        * deleted. Also version is set to 0.
        * @since 2.8
        * @param aIssuerAndSerialNumber IssuerAndSerialNumber value.
        */
		IMPORT_C void SetIssuerAndSerialNumberL(
            const CCMSIssuerAndSerialNumber& aIssuerAndSerialNumber );

		/**
        * Setter for subjectKeyIdentifier. Creates a copy of the parameters.
        * Note that any existing IssuerAndSerialNumber value is
        * deleted. Also version is set to 2.
        * @since 2.8
        * @param aSubjectKeyIdentifier SubjectKeyIdentifier value.
        */
		IMPORT_C void SetSubjectKeyIdentifierL(
            const TDesC8& aSubjectKeyIdentifier );

    public: // Functions from base classes

	 	/**
        * From MCMSModule
        * @since 2.8
        * @param aRawData raw-data to be parsed in this instance
        */
        void DecodeL( const TDesC8& aRawData );

	 	/**
        * From MCMSModule
        * @since 2.8
        * @return Returns ASN1 encoder and leaves it in CleanupStack
        */
        CASN1EncBase* EncoderLC() const;
        
        /**
         * From CCMSRecipientInfo
         * @since 2.8
         * @return Returns ASN1 encoder with explicit tag 1 and leaves
         * it in CleanupStack.
         */
        CASN1EncBase* TaggedEncoderLC() const;
        
    protected:  // New functions

	   /**
        * Protected construction to allow derivation
        */
        IMPORT_C void ConstructL(
            const CCMSIssuerAndSerialNumber& aIssuerAndSerialNumber,
            const CCMSX509AlgorithmIdentifier& aKeyEncryptionAlgorithm,
            const TDesC8& aEncryptedKey );

       /**
        * Protected construction to allow derivation
        */
        IMPORT_C void ConstructL(
            const TDesC8& aSubjectKeyIdentifier,
            const CCMSX509AlgorithmIdentifier& aKeyEncryptionAlgorithm,
            const TDesC8& aEncryptedKey );

        /**
        * C++ constructor.
        */
        IMPORT_C CCMSKeyTransRecipientInfo( TInt aVersion );

    private:    // Data
        // EncryptedKey, owned
        TDesC8* iEncryptedKey;
        // IssuerAndSerialNumber, owned
        CCMSIssuerAndSerialNumber* iIssuerAndSerialNumber;
        // RecipientEncryptedKey, owned
        TDesC8* iSubjectKeyIdentifier;

    };

#endif      // CCMSKeyTransRecipientInfo_H

// End of File