diff -r 000000000000 -r 164170e6151a secsrv_plat/cms_api/inc/CCMSKeyIdentifier.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/secsrv_plat/cms_api/inc/CCMSKeyIdentifier.h Tue Jan 26 15:20:08 2010 +0200 @@ -0,0 +1,182 @@ +/* +* 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