diff -r 000000000000 -r 164170e6151a secsrv_plat/cms_api/inc/CCMSOriginatorIdentifierOrKey.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/secsrv_plat/cms_api/inc/CCMSOriginatorIdentifierOrKey.h Tue Jan 26 15:20:08 2010 +0200 @@ -0,0 +1,238 @@ +/* +* 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 CCMSOriginatorIdentifierOrKey_H +#define CCMSOriginatorIdentifierOrKey_H + +// INCLUDES +#include +#include +#include "MCMSModule.h" + +// FORWARD DECLARATIONS +class CCMSIssuerAndSerialNumber; +class CCMSOriginatorPublicKey; +class CASN1EncBase; + +// CLASS DECLARATION +/** +* OriginatorIdentifierOrKey type module +* +* ASN.1 definition: +* OriginatorIdentifierOrKey ::= CHOICE { +* issuerAndSerialNumber IssuerAndSerialNumber, +* subjectKeyIdentifier [0] SubjectKeyIdentifier, +* originatorKey [1] OriginatorPublicKey } +* @lib cms.lib +* @since 2.8 +*/ +class CCMSOriginatorIdentifierOrKey : public CBase, public MCMSModule + { + public: // data types + enum TType + { + ESubjectKeyIdentifier = 0, + EOriginatorKey = 1, + EIssuerAndSerialNumber + }; + + public: // Constructors and destructor + /** + * Two-phased constructor. + */ + IMPORT_C static CCMSOriginatorIdentifierOrKey* NewL(); + + /** + * Two-phased constructor. Copies of the parameters are made. + * + * @param aIssuerAndSerialNumber identifies sender's certificate + */ + IMPORT_C static CCMSOriginatorIdentifierOrKey* NewL( + const CCMSIssuerAndSerialNumber& aIssuerAndSerialNumber ); + + /** + * Two-phased constructor. Copies of the parameters are made. + * + * @param aSubjectKeyIdentifier X.509 subjectKeyIdentifier + */ + IMPORT_C static CCMSOriginatorIdentifierOrKey* NewL( + const TDesC8& aSubjectKeyIdentifier ); + + /** + * Two-phased constructor. Copies of the parameters are made. + * + * @param aOriginatorKey includes algorithm identifier and public key + */ + IMPORT_C static CCMSOriginatorIdentifierOrKey* NewL( + const CCMSOriginatorPublicKey& aOriginatorKey ); + + /** + * Destructor. + */ + virtual ~CCMSOriginatorIdentifierOrKey(); + + public: // New functions + /** + * Getter for the CHOICE type. There is no corresponding + * setter method as the type is set implicitly by the member + * value setters. + * @since 2.8 + * @return the CHOICE type + */ + IMPORT_C TType Type() const; + + /** + * Getter for IssuerAndSerialNumber. Leaves with KErrNotFound + * if the type of this CHOICE is not EIssuerAndSerialNumber. + * @since 2.8 + * @return IssuerAndSerialNumber + */ + IMPORT_C const CCMSIssuerAndSerialNumber& + IssuerAndSerialNumberL() const; + + /** + * Getter for the X.509 subjectKeyIdentifier. Leaves with + * KErrNotFound if the type of this CHOICE is not ESubjectKeyIdentifier. + * @since 2,8 + * @return subjectKeyIdentifier + */ + IMPORT_C const TDesC8& SubjectKeyIdentifierL() const; + + /** + * Getter for OriginatorKey. Leaves with KErrNotFound if the + * type of this CHOICE is not EOriginatorKey. + * @since 2,8 + * @return OriginatorKey + */ + IMPORT_C const CCMSOriginatorPublicKey& OriginatorKeyL() const; + + /** + * Setter for IssuerAndSerialNumber. Create a copy of the parameters. + * @since 2.8 + * @param aIssuerAndSerialNumber identifies sender's certificate + */ + IMPORT_C void SetIssuerAndSerialNumberL( + const CCMSIssuerAndSerialNumber& aIssuerAndSerialNumber ); + + /** + * Setter for subjectKeyIdentifier + * @since 2,8 + * @param aSubjectKeyIdentifier X.509 subjectKeyIdentifier + */ + IMPORT_C void SetSubjectKeyIdentifierL( + const TDesC8& aSubjectKeyIdentifier ); + + /** + * Setter for originatorKey + * @since 2.8 + * @param aOriginatorKey includes algorithm identifier and + * public key + */ + IMPORT_C void SetOriginatorKeyL( + const CCMSOriginatorPublicKey& aOriginatorKey ); + + public: // Functions from base classes + + /** + * From MCMSModule + * @since 2.8 + * @param aResult Allocates and sets result in this variable + * @return ?description + */ + void EncodeL( HBufC8*& aResult ) const; + + /** + * 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; + + protected: // New functions + + /** + * Protected construction to allow derivation + */ + IMPORT_C void ConstructL( + const CCMSIssuerAndSerialNumber& aIssuerAndSerialNumber ); + + /** + * Protected construction to allow derivation + */ + IMPORT_C void ConstructL( + const TDesC8& aSubjectKeyIdentifier ); + + /** + * Protected construction to allow derivation + */ + IMPORT_C void ConstructL( + const CCMSOriginatorPublicKey& aOriginatorKey ); + + /** + * C++ default constructor. + */ + IMPORT_C CCMSOriginatorIdentifierOrKey(); + + private: // New functions + + /** + * Deletes old value and changes the type of the choice. + * @param aNewType The type of the CHOICE will be set to + * aNewType. + */ + void DeleteOldValueAndChangeTypeL( TType aNewType ); + + /** + * Creates Encoder for the SubjectKeyIdentifier value + * @return ASN1 encoder + */ + CASN1EncBase* EncoderSubjectKeyIdentifierLC() const; + + /** + * Creates Encoder for the OriginatorKey value + * @return ASN1 encoder + */ + CASN1EncBase* EncoderOriginatorKeyLC() const; + + private: // Data + + // defines the type of this CHOICE + TType iType; + + // IssuerAndSerialNumber value. owned. + CCMSIssuerAndSerialNumber* iIssuerAndSerialNumber; + + // SubjectKeyIdentifier value. owned. + HBufC8* iSubjectKeyIdentifier; + + // OriginatorPublicKey value. owned. + CCMSOriginatorPublicKey* iOriginatorKey; + + }; + +#endif // CCMSOriginatorIdentifierOrKey_H + +// End of File