/*
* 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:  CMS KeyIdentifier type
*
*/



#ifndef CCMSKeyIdentifier_H
#define CCMSKeyIdentifier_H

#include "CCMSSequence.h"

// FORWARD DECLARATIONS
// Extension
class MCMSKeyIdentifierExtension;

// CLASS DECLARATION
/**
*  This module handles two ASN.1 types, RecipientKeyIdentifier and
*  KEKIdentifier.
*
*  ASN.1 definitions:
*    RecipientKeyIdentifier ::= SEQUENCE {
*        subjectKeyIdentifier SubjectKeyIdentifier,
*        date GeneralizedTime OPTIONAL,
*        other OtherKeyAttribute OPTIONAL }
*
*    SubjectKeyIdentifier ::= OCTET STRING
*
*    KEKIdentifier ::= SEQUENCE {
*        keyIdentifier OCTET STRING,
*        date GeneralizedTime OPTIONAL,
*        other OtherKeyAttribute OPTIONAL }
*
*  @lib cms.lib
*  @since 3.0
*/
class CCMSKeyIdentifier : public CCMSSequence
    {
    public:  // Constructors and destructor
		/**
        * Two-phased constructor.
        */
        IMPORT_C static CCMSKeyIdentifier* NewL();

        /**
        * Two-phased constructor. Copies of the parameters are made.
        *
        * @param aKeyIdentifier identifies the recipient's
        * certificate or the the key-encryption key that was
        * previously distributed to the sender and one or more recipients.
        */
        IMPORT_C static CCMSKeyIdentifier* NewL(
            const TDesC8& aKeyIdentifier );

        /**
        * Two-phased constructor. Copies of the parameters are made.
        *
        * @param aKeyIdentifier identifies the recipient's
        * certificate or the the key-encryption key that was
        * previously distributed to the sender and one or more recipients.
        * @param aDate specifies which of the
        * recipient's previously distributed UKMs was used by the
        * sender. In case of KEKIdentifier, specifies a single
        * key-encryption key from a set.
        */
        IMPORT_C static CCMSKeyIdentifier* NewL(
            const TDesC8& aKeyIdentifier,
            const TTime& aDate );

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

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

        /**
        * Getter for Date. Ownership is not transferred.
        * @since 2,8
        * @return Date. Ownership is not transferred.
        */
		IMPORT_C const TTime* Date() const;

		/**
        * Setter for KeyIdentifier. Creates a copy of the parameters.
        * @since 3.0
        * @param aKeyIdentifier KeyIdentifier value.
        */
		IMPORT_C void SetKeyIdentifierL(
            const TDesC8& aKeyIdentifier );

        /**
        * Setter for Date. Creates a copy of the parameters.
        * @since 3.0
        * @param aDate Date value
        */
		IMPORT_C void SetDateL( const TTime& aDate );

        /**
         * Decoder method with implicit tag checking.
         * @since 3.0
         * @param aRawData raw-data to be parsed in this instance
         * @param aImplicitTag tag to be checked
         */
        void DecodeImplicitTagL( const TDesC8& aRawData,
                                 const TTagType aImplicitTag );

    public: // Functions from base classes

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

	 	/**
        * From MCMSModule
        * @since 3.0
        * @return Returns ASN1 encoder and leaves it in CleanupStack
        */
        CASN1EncBase* EncoderLC() const;

    protected:  // New functions

	   /**
        * Protected construction to allow derivation
        */
        IMPORT_C void ConstructL( const TDesC8& aKeyIdentifier );

       /**
        * Protected construction to allow derivation
        */
        IMPORT_C void ConstructL( const TDesC8& aKeyIdentifier,
                                  const TTime& aDate );

        /**
        * C++ default constructor.
        */
        IMPORT_C CCMSKeyIdentifier();

    private: // New Methods

        /**
         * Decodes internal data from a array of ASN.1 decoders
         * @param aItems items to internalize
         */
        void DecodeArrayL( CArrayPtr< TASN1DecGeneric >* aItems );

    private:    // Data
        // KeyIdentifier, owned
        TDesC8* iKeyIdentifier;
        // Date, owned
		TTime* iDate;

        // Reserved for extensions
        MCMSKeyIdentifierExtension* iReserved;
        
    };

#endif      // CCMSKeyIdentifier_H

// End of File