/*
* 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 CCMSRecipientEncryptedKey_H
#define CCMSRecipientEncryptedKey_H
#include "CCMSSequence.h"
// FORWARD DECLARATIONS
class CCMSIssuerAndSerialNumber;
class CCMSKeyIdentifier;
// CLASS DECLARATION
/**
* RecipientEncryptedKey type module
*
* ASN.1 definition:
* RecipientEncryptedKey ::= SEQUENCE {
* rid KeyAgreeRecipientIdentifier,
* encryptedKey EncryptedKey }
*
* KeyAgreeRecipientIdentifier ::= CHOICE {
* issuerAndSerialNumber IssuerAndSerialNumber,
* rKeyId [0] IMPLICIT RecipientKeyIdentifier }
*
* EncryptedKey ::= OCTET STRING
*
* @lib cms.lib
* @since 2.8
*/
class CCMSRecipientEncryptedKey : public CCMSSequence
{
public: // Constructors and destructor
/**
* Two-phased constructor.
*/
IMPORT_C static CCMSRecipientEncryptedKey* NewL();
/**
* Two-phased constructor. Copies of the parameters are made.
*
* @param aIssuerAndSerialNumber rid (KeyAgreeRecipientIdentifier) value
* @param aEncryptedKey EncryptedKey value
*/
IMPORT_C static CCMSRecipientEncryptedKey* NewL(
const CCMSIssuerAndSerialNumber& aIssuerAndSerialNumber,
const TDesC8& aEncryptedKey );
/**
* Two-phased constructor. Copies of the parameters are made.
*
* @param aRKeyId rid (KeyAgreeRecipientIdentifier) value
* @param aEncryptedKey EncryptedKey value
*/
IMPORT_C static CCMSRecipientEncryptedKey* NewL(
const CCMSKeyIdentifier& aRKeyId,
const TDesC8& aEncryptedKey );
/**
* Destructor.
*/
virtual ~CCMSRecipientEncryptedKey();
public: // New functions
/**
* Getter for EncryptedKey
* @since 2.8
* @return EncryptedKey
*/
IMPORT_C const TDesC8& EncryptedKey() const;
/**
* Getter for IssuerAndSerialNumber. Ownership is not transferred.
* @since 2,8
* @return IssuerAndSerialNumber or NULL if rid is not
* IssuerAndSerialNumber
*/
IMPORT_C const CCMSIssuerAndSerialNumber* IssuerAndSerialNumber() const;
/**
* Getter for rKeyId. Ownership is not transferred.
* @since 2,8
* @return rKeyId or NULL if rid is not rKeyId.
*/
IMPORT_C const CCMSKeyIdentifier* RKeyId() const;
/**
* Setter for EncryptedKey. Creates a copy of the parameters.
* @since 2.8
* @param aEncryptedKey EncryptedKey value.
*/
IMPORT_C void SetEncryptedKeyL(
const TDesC8& aEncryptedKey );
/**
* Setter for IssuerAndSerialNumber. Creates a copy of the parameters.
* Note that any existing rKeyId value is deleted.
* @since 2.8
* @param aIssuerAndSerialNumber IssuerAndSerialNumber value.
*/
IMPORT_C void SetIssuerAndSerialNumberL(
const CCMSIssuerAndSerialNumber& aIssuerAndSerialNumber );
/**
* Setter for rKeyId. Creates a copy of the parameters.
* Note that any existing IssuerAndSerialNumber value is deleted.
* @since 2.8
* @param aRKeyId RecipientEncryptedKey value.
*/
IMPORT_C void SetRKeyIdL(
const CCMSKeyIdentifier& aRKeyId );
public: // Functions from base classes
/**
* 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,
const TDesC8& aEncryptedKey );
/**
* Protected construction to allow derivation
*/
IMPORT_C void ConstructL(
const CCMSKeyIdentifier& aRKeyId,
const TDesC8& aEncryptedKey );
/**
* C++ default constructor.
*/
IMPORT_C CCMSRecipientEncryptedKey();
private: // Data
// EncryptedKey, owned
TDesC8* iEncryptedKey;
// IssuerAndSerialNumber, owned
CCMSIssuerAndSerialNumber* iIssuerAndSerialNumber;
// RecipientEncryptedKey, owned
CCMSKeyIdentifier* iRKeyId;
};
#endif // CCMSRecipientEncryptedKey_H
// End of File