/*
* Copyright (c) 2002 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 CCMSSequence_H
#define CCMSSequence_H

//  INCLUDES
#include 	"MCMSModule.h"
#include 	<asn1dec.h>
#include 	<asn1enc.h>

// CLASS DECLARATION
/**
*  Base class for sequence (or set) type of modules.
*
*  @lib cms.lib
*  @since 2.8
*/
class CCMSSequence : public CBase, public MCMSModule
    {
	public: // From MCMSModule
		/**
        * From MCMSModule
        * @since 2.8
        * @param aResult Allocates and sets result in this variable
        * @return ?description
        */
        void EncodeL( HBufC8*& aResult ) const;

    protected:  // New functions
       /**
        * C++ default constructor.
        */
        CCMSSequence();

        /**
        * Decode a generic ASN1 sequence
        * @since 2.8
        * @param aRawData raw-data to be splitted in ASN.1 Modules
        * @return Array of generic asn.1 modules.
        */
        IMPORT_C static CArrayPtr<TASN1DecGeneric>* DecodeSequenceLC( const TDesC8& aRawData );

        /**
		* Decode a generic ASN1 sequence, with a minimum/maximum number
		* of top level terms. Will leave with KErrArgument if number of terms
		* is not between valid range (including min and max)
		* @since 2.8
		* @param aRawData raw-data to be splitted in ASN.1 Modules
		* @param aMinTerms minimum of top level terms.
		* @param aMaxTerms maximum number of top level terms.
		* @return Array of generic asn.1 modules.
        */
        IMPORT_C static CArrayPtr<TASN1DecGeneric>* DecodeSequenceLC( const TDesC8& aRawData,
        															  TInt aMinTerms,
        															  TInt aMaxTerms );
		/**
         * Creates DER encoded descriptor and leaves it to 
		 * CleanupStack
		 * @since 2.8
		 * @param aEncoding base encoding to be encoded
		 * @return new heap buffer containing der encoded content
         */
		IMPORT_C static HBufC8* CreateDerEncodingL( CASN1EncBase* aEncoding );

    };

// taken from MMF, did not want to make dependency to MMF
template <class T>
class CleanupResetAndDestroy
	{
public:
	inline static void PushL(T& aRef);
private:
	static void ResetAndDestroy(TAny *aPtr);
	};
template <class T>
inline void CleanupResetAndDestroyPushL(T& aRef);
template <class T>
inline void CleanupResetAndDestroy<T>::PushL(T& aRef)
	{CleanupStack::PushL(TCleanupItem(&ResetAndDestroy,&aRef));}
template <class T>
void CleanupResetAndDestroy<T>::ResetAndDestroy(TAny *aPtr)
	{(STATIC_CAST(T*,aPtr))->ResetAndDestroy();}
template <class T>
inline void CleanupResetAndDestroyPushL(T& aRef)
	{CleanupResetAndDestroy<T>::PushL(aRef);}

#endif      // CCMSSequence_H

// End of File