cryptoservices/certificateandkeymgmt/inc/cmscertchoice.h
changeset 8 35751d3474b7
parent 0 2c201484c85f
--- a/cryptoservices/certificateandkeymgmt/inc/cmscertchoice.h	Tue Jul 21 01:04:32 2009 +0100
+++ b/cryptoservices/certificateandkeymgmt/inc/cmscertchoice.h	Thu Sep 10 14:01:51 2009 +0300
@@ -1,194 +1,192 @@
-/*
-* Copyright (c) 2006-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: 
-*
-*/
-
-
-
-
-/**
- @file
- @publishedPartner
- @released
-*/
-
-
-#ifndef CMSCERTCHOICE_H
-#define CMSCERTCHOICE_H
-
-#include <e32base.h>
-
-class CX509Certificate;
-class CASN1EncEncoding;
-
-/**
-An instance of a member of the RFC2630 CertificateChoices.
-At present, only X509 certificates and attribute certificate are supported.
-(not PKCS#6 extended certificates).
-*/
-class CCmsCertificateChoice : public CBase
-	{
-public:
-	/**
-	Certificate Types
-	*/
-	enum TCertificateType
-		{
-		/**
-		X.509 Certificate.
-		*/
-		ECertificateX509,
-		/**
-		Extended Certificate.
-		*/
-		ECertificateExtendedCerificate,
-		/**
-		Attribute Certificate.
-		*/
-		ECertificateAttribute
-		};
-		
-	/**
-	 * @internalComponent
-	 * 
-	 * Creates a CertificateChoices as defined in RFC2630.
-	 * @param aCertificate The X509 certificate used to build the CertificateChoices object.
-	 * The newly created object will create a copy of aCertificate.	
-	 * @return The fully constructed object.
-	 **/
-	static CCmsCertificateChoice* NewL(const CX509Certificate& aCertificate);
-
-	/**
-	 * @internalComponent
-	 *
-	 * Creates a CertificateChoices object as defined in RFC2630
-	 * and leaves the object on the cleanup stack.
-	 * @param aCertificate The X509 certificate used to build the CertificateChoices object.
-	 * The newly created object will create a copy of aCertificate.	
-	 * @return The fully constructed object.
-	 **/
-	static CCmsCertificateChoice* NewLC(const CX509Certificate& aCertificate);
-
-	/**
-	 * @internalComponent
-	 *
-	 * Creates a CertificateChoices object as defined in RFC2630.
-	 * @param aCertType The encoded certificate type. ECertificateExtendedCerificate is not supported.
-	 * @param aEncodedCertificate The encoded certificate used to build the CertificateChoices object.
-	 * The newly created object will create a copy of aEncodedCertificate.
-	 * @return The fully constructed object.
-	 **/	
-	static CCmsCertificateChoice* NewL(TCertificateType aCertType, const TDesC8& aEncodedCertificate);
-	
-	/**
-	 * @internalComponent
-	 * 
-	 * Creates a CertificateChoices object as defined in RFC2630 and leaves the object on the cleanup stack.
-	 * @param aCertType The encoded certificate type. ECertificateExtendedCerificate is not supported.
-	 * @param aEncodedCertificate The encoded certificate used to build the CertificateChoices object.
-	 * The newly created object will create a copy of aEncodedCertificate.
-	 * @return The fully constructed object.
-	 **/		
-	static CCmsCertificateChoice* NewLC(TCertificateType aCertType, const TDesC8& aEncodedCertificate);
-	
-	/**
-	 * @internalComponent
-	 * 
-	 * Creates a CertificateChoices object as defined in RFC2630.
-	 * @param aRawData The encoded CertificateChoices object to be decoded.
-	 * @return The fully constructed object.
-	 **/			
-	static CCmsCertificateChoice* NewL(const TDesC8& aRawData);
-	
-	/**
-	Destructor
-	*/
-	virtual ~CCmsCertificateChoice();
-	
-	/**
-	Returns the type of the CertificateChoices object
-	@return The type of the certificate.
-	*/
-	IMPORT_C TCertificateType CertificateType();
-	
-	/**
-	Returns the x509 certificate reference if the certificate is a X509 certificate.
-	Callers need to check whether the certificate's type is X509 beforehand.
-	@return The x509 certificate reference.
-	*/
-	IMPORT_C const CX509Certificate& Certificate(void) const;
-
-	/**
-	Returns the encoded certificate's buffer. If the certificate is not an
-	attribute certificate, NULL is returned. Callers can also check whether 
-	the certificate's type is X509 beforehand.
-	@return A pointer to the encoded certificate buffer.
-	*/
-	IMPORT_C const HBufC8* AttributeCertificate() const;
-
-	/**
-	 * @internalComponent
-	 *
-	 * Creates the ASN1 DER sequence of the CertificateChoices object
-	 * and leaves it on the cleanup stack.
-	 * @return  ASN1 DER sequence of this object.
-	 **/		
-	CASN1EncEncoding* EncodeASN1DERLC() const;
-
-private:
-	/**
-	Default Constructor
-	*/
-	CCmsCertificateChoice();
-	
-	
-	/**
-	Second phase constructor for decoding.
-	@param aRawData the raw data to be decoded.
-	*/
-	void ConstructL(const TDesC8& aRawData);
-	
-	/**
-	Second phase constructor for encoding.
-	@param aCertificate the X509 certificate used to create the object
-	*/
-	void ConstructL(const CX509Certificate& aCertificate);
-
-	/**
-	Second phase constructor for encoding.
-	@param aCertType The encoded certificate type. ECertificateExtendedCerificate is not supported
-	@param aEncodedCertificate the encoded certificate used to create the object
-	*/	
-	void ConstructL(TCertificateType aCertType, const TDesC8& aEncodedCertificate);
-
-	
-private:
-	/**
-	The type the embedded certificate type
-	*/
-	TCertificateType iCertificateType;
-	
-	/**
-	The X509 certificate pointer
-	*/
-	CX509Certificate* iCertificate;
-	
-	/**
-	The attribute certificate buffer
-	*/	
-	HBufC8* iEncodedAttributeCertificate;
-	};
-	
-#endif
+/*
+* Copyright (c) 2006-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: 
+*
+*/
+
+
+/**
+ @file
+ @publishedPartner
+ @released
+*/
+
+
+#ifndef CMSCERTCHOICE_H
+#define CMSCERTCHOICE_H
+
+#include <e32base.h>
+
+class CX509Certificate;
+class CASN1EncEncoding;
+
+/**
+An instance of a member of the RFC2630 CertificateChoices.
+At present, only X509 certificates and attribute certificate are supported.
+(not PKCS#6 extended certificates).
+*/
+class CCmsCertificateChoice : public CBase
+	{
+public:
+	/**
+	Certificate Types
+	*/
+	enum TCertificateType
+		{
+		/**
+		X.509 Certificate.
+		*/
+		ECertificateX509,
+		/**
+		Extended Certificate.
+		*/
+		ECertificateExtendedCerificate,
+		/**
+		Attribute Certificate.
+		*/
+		ECertificateAttribute
+		};
+		
+	/**
+	 * @internalComponent
+	 * 
+	 * Creates a CertificateChoices as defined in RFC2630.
+	 * @param aCertificate The X509 certificate used to build the CertificateChoices object.
+	 * The newly created object will create a copy of aCertificate.	
+	 * @return The fully constructed object.
+	 **/
+	static CCmsCertificateChoice* NewL(const CX509Certificate& aCertificate);
+
+	/**
+	 * @internalComponent
+	 *
+	 * Creates a CertificateChoices object as defined in RFC2630
+	 * and leaves the object on the cleanup stack.
+	 * @param aCertificate The X509 certificate used to build the CertificateChoices object.
+	 * The newly created object will create a copy of aCertificate.	
+	 * @return The fully constructed object.
+	 **/
+	static CCmsCertificateChoice* NewLC(const CX509Certificate& aCertificate);
+
+	/**
+	 * @internalComponent
+	 *
+	 * Creates a CertificateChoices object as defined in RFC2630.
+	 * @param aCertType The encoded certificate type. ECertificateExtendedCerificate is not supported.
+	 * @param aEncodedCertificate The encoded certificate used to build the CertificateChoices object.
+	 * The newly created object will create a copy of aEncodedCertificate.
+	 * @return The fully constructed object.
+	 **/	
+	static CCmsCertificateChoice* NewL(TCertificateType aCertType, const TDesC8& aEncodedCertificate);
+	
+	/**
+	 * @internalComponent
+	 * 
+	 * Creates a CertificateChoices object as defined in RFC2630 and leaves the object on the cleanup stack.
+	 * @param aCertType The encoded certificate type. ECertificateExtendedCerificate is not supported.
+	 * @param aEncodedCertificate The encoded certificate used to build the CertificateChoices object.
+	 * The newly created object will create a copy of aEncodedCertificate.
+	 * @return The fully constructed object.
+	 **/		
+	static CCmsCertificateChoice* NewLC(TCertificateType aCertType, const TDesC8& aEncodedCertificate);
+	
+	/**
+	 * @internalComponent
+	 * 
+	 * Creates a CertificateChoices object as defined in RFC2630.
+	 * @param aRawData The encoded CertificateChoices object to be decoded.
+	 * @return The fully constructed object.
+	 **/			
+	static CCmsCertificateChoice* NewL(const TDesC8& aRawData);
+	
+	/**
+	Destructor
+	*/
+	virtual ~CCmsCertificateChoice();
+	
+	/**
+	Returns the type of the CertificateChoices object
+	@return The type of the certificate.
+	*/
+	IMPORT_C TCertificateType CertificateType();
+	
+	/**
+	Returns the x509 certificate reference if the certificate is a X509 certificate.
+	Callers need to check whether the certificate's type is X509 beforehand.
+	@return The x509 certificate reference.
+	*/
+	IMPORT_C const CX509Certificate& Certificate(void) const;
+
+	/**
+	Returns the encoded certificate's buffer. If the certificate is not an
+	attribute certificate, NULL is returned. Callers can also check whether 
+	the certificate's type is X509 beforehand.
+	@return A pointer to the encoded certificate buffer.
+	*/
+	IMPORT_C const HBufC8* AttributeCertificate() const;
+
+	/**
+	 * @internalComponent
+	 *
+	 * Creates the ASN1 DER sequence of the CertificateChoices object
+	 * and leaves it on the cleanup stack.
+	 * @return  ASN1 DER sequence of this object.
+	 **/		
+	CASN1EncEncoding* EncodeASN1DERLC() const;
+
+private:
+	/**
+	Default Constructor
+	*/
+	CCmsCertificateChoice();
+	
+	
+	/**
+	Second phase constructor for decoding.
+	@param aRawData the raw data to be decoded.
+	*/
+	void ConstructL(const TDesC8& aRawData);
+	
+	/**
+	Second phase constructor for encoding.
+	@param aCertificate the X509 certificate used to create the object
+	*/
+	void ConstructL(const CX509Certificate& aCertificate);
+
+	/**
+	Second phase constructor for encoding.
+	@param aCertType The encoded certificate type. ECertificateExtendedCerificate is not supported
+	@param aEncodedCertificate the encoded certificate used to create the object
+	*/	
+	void ConstructL(TCertificateType aCertType, const TDesC8& aEncodedCertificate);
+
+	
+private:
+	/**
+	The type the embedded certificate type
+	*/
+	TCertificateType iCertificateType;
+	
+	/**
+	The X509 certificate pointer
+	*/
+	CX509Certificate* iCertificate;
+	
+	/**
+	The attribute certificate buffer
+	*/	
+	HBufC8* iEncodedAttributeCertificate;
+	};
+	
+#endif