/*
* Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the License "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: 
* CEncryptedProtectionKey declaration
*
*/


/**
 @file 
 @released
 @internalComponent
*/

#ifndef ENCRYPTEDPROTECTIONKEY_H
#define ENCRYPTEDPROTECTIONKEY_H

#include "authcommon_impl.h"

namespace AuthServer
{

/**
 * CEncryptedProtectionKey containst the encrypted version of an identity's
 * protection key.  Encrypted protection keys are generated via the
 * CTransientKey class and are stored on the device, unlike the raw
 * protection key data.
 */
class CEncryptedProtectionKey : public CBase
	{
public:	

	/**
	 * Creates a new encrypted key, passing in the encrypted key data. Should
	 * really only be called by a CTransientKey::EncryptL. The new object
	 * assumes ownership of the data.
	 *
	 * @param aKeyData the data to use as the encrypted key
	 **/
	static CEncryptedProtectionKey* NewL(HBufC8* aKeyData);
	
	/**
	 * Creates a new encrypted key, passing in the encrypted key data. Should
	 * really only be called by a CTransientKey::EncryptL
	 *
	 * @param aKeyData the data to use as the encrypted key
	 **/
	static CEncryptedProtectionKey* NewLC(HBufC8* aKeyData);
	
	/**
	 * Internalize a persisted key  from the stream.
	 * @param aSrcData the source data
	 **/
	static CEncryptedProtectionKey* NewL(RReadStream& aSrcData);	

	/**
	 * Internalize a persisted key from the stream.
	 * @param aSrcData the source data
	 **/
	static CEncryptedProtectionKey* NewLC(RReadStream& aSrcData);

	/**
	 * Returns a descriptor to the encrypted key data
	 *
	 * @return a descriptor pointing to the encrypted key data. 
	 **/
	TPtrC8 KeyData() const;

	/**
	 * Writes the key data to the specified write stream. The key can be
	 * recreated using the appropriate NewL member.
	 *
	 * @param aDest the destination write stream.
	 *
	 **/
	void ExternalizeL(RWriteStream& aDest) const;
	
	~CEncryptedProtectionKey();

private:
	void ConstructL(HBufC8* aKeyData);
	void InternalizeL(RReadStream& aSrcData);

	HBufC8* iKeyData;
    };

}

#endif // ENCRYPTEDPROTECTIONKEY_H