/*
* 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:  X.509 AttributeCertificate type
*
*/



#ifndef CCMSX509AttributeCertificate_H
#define CCMSX509AttributeCertificate_H

#include "CCMSSequence.h"
#include "CCMSX509Signed.h"

// FORWARD DECLARATIONS
class CCMSX509AttributeCertificateInfo;
class CCMSX509AlgorithmIdentifier;

// Extensions
class MCMSX509AttributeCertificateExtension;

// CLASS DECLARATION
/**
*  X.509 AttributeCertificateInfo type module
*
*  ASN.1 definition:
* AttributeCertificate ::= SIGNED{AttributeCertificateInfo}
*
* SIGNATURE{ToBeSigned} ::= SEQUENCE {
*  algorithmIdentifier  AlgorithmIdentifier,
*  encrypted            ENCRYPTED-HASH{ToBeSigned}
* }
*
* SIGNED{ToBeSigned} ::= SEQUENCE {
*  toBeSigned  ToBeSigned,
*  COMPONENTS OF SIGNATURE{ToBeSigned}
* }
*
*  @lib cms.lib
*  @since 3.0
*/
class CCMSX509AttributeCertificate : public CCMSX509Signed
    {

    public:  // Constructors and destructor
		/**
        * Two-phased constructor.
        */
        IMPORT_C static CCMSX509AttributeCertificate* NewL();

        /**
        * Two-phased constructor. Copies of the parameters are made.
        * 
        * @param aInfo AttributeCertificateInfo, contains the actual
        * data of the certificate.
        * @param aAlgorithmIdentifier identifies the algorithm used in
        * the signature 
        * @param aEncrypted must be the result of applying a hashing
        * procedure to the DER-encoded octets of a value of
        * aInfo and then applying an encipherment
        * procedure to those octets
        */
        IMPORT_C static CCMSX509AttributeCertificate* NewL(
            const CCMSX509AttributeCertificateInfo& aInfo,
            const CCMSX509AlgorithmIdentifier& aAlgorithmIdentifier,
            const TDesC8& aEncrypted
            );
        
        /**
        * Destructor.
        */
        virtual ~CCMSX509AttributeCertificate();

    public: // New functions
        /**
        * Getter for the info.
        * @since 3.0
        * @return X.509 AttributeCertificateInfo value
        */
		IMPORT_C const CCMSX509AttributeCertificateInfo& Info() const;

        /**
        * Setter for the info. Creates a copy.
        * @since 3.0
        * @param aInfo X.509 AttributeCertificateInfo
        */
		IMPORT_C void SetInfoL( const CCMSX509AttributeCertificateInfo& aInfo );

        /**
         * 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 CCMSX509AttributeCertificateInfo& aInfo,
            const CCMSX509AlgorithmIdentifier& aAlgorithmIdentifier,
            const TDesC8& aEncrypted
            );

        /**
         * Protected construction to allow derivation
         */
        IMPORT_C void ConstructL( );
        
        /**
        * C++ default constructor.
        */
        IMPORT_C CCMSX509AttributeCertificate( );
        
    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
        // Contains the actual attribute certificate (without
        // signature). Owned.
        CCMSX509AttributeCertificateInfo* iInfo;

        // Reserved for extensions
        MCMSX509AttributeCertificateExtension* iReserved;
        
    };

#endif      // CCMSX509AttributeCertificate_H

// End of File