Symbian
 Developer Library

DEVELOPER LIBRARY

[Index] [Glossary] [Previous] [Next]



Location: x509cert.h
Link against: x509.lib

Class CX509Certificate

CX509Certificate

Support

Supported from 6.0

Description

A X.509 certificate.

Derivation

CBaseBase class for all classes to be instantiated on the heap
CCertificateA data structure that binds a public key to a given individual
CSignedObjectBase class for certificates
CX509CertificateA X.509 certificate

Defined in CX509Certificate:
Extension(), Extensions(), InternalizeL(), IsEqualL(), IssuerName(), NewL(), NewL(), NewL(), NewL(), NewL(), NewLC(), NewLC(), NewLC(), NewLC(), NewLC(), SubjectName(), Version(), ~CX509Certificate()

Inherited from CBase:
operator new()

Inherited from CCertificate:
PublicKey(), SerialNumber(), ValidityPeriod()

Inherited from CSignedObject:
DataElementEncoding(), Encoding(), ExternalizeL(), Fingerprint(), SetParametersL(), Signature(), SignedDataL(), SigningAlgorithm(), VerifySignatureL()


Construction and destruction


NewL()

static CX509Certificate* NewL(const TDesC8& aBinaryData);

Description

Creates a new X.509 certificate object from the specified buffer containing the binary coded representation.

Parameters

const TDesC8& aBinaryData

The encoded binary representation.

Return value

CX509Certificate*

The new X.509 certificate object.


NewL()

static CX509Certificate* NewL(const TDesC8& aBinaryData, TInt& aPos);

Description

Creates a new X.509 certificate object from the specified buffer containing the binary coded representation, starting at the specified offset.

Parameters

const TDesC8& aBinaryData

The encoded binary representation.

const TInt& aPos

The offset position from which to start decoding.

Return value

CX509Certificate*

The new X.509 certificate object.


NewL()

static CX509Certificate* NewL(RReadStream& aStream);

Description

Creates a new X.509 certificate object from the specified read stream.

Parameters

RReadStream& aStream

The read stream.

Return value

CX509Certificate*

The new X.509 object.


NewL()

static CX509Certificate* NewL(const CCertStore& aStore, const CCertStoreEntry& aEntry);

Description

Creates a new X.509 certificate by loading the specified certificate store entry from the specified certificate store.

Parameters

const CCertStore& aStore

The certificate store.

const CCertStoreEntry& aEntry

The certificate store entry.

Return value

CX509Certificate*

The new X.509 certificate object.


NewL()

static CX509Certificate* NewL(const CX509Certificate& aCert);

Description

Creates a new X.509 certificate object from an existing object.

This is equivalent to a copy constructor.

Parameters

const CX509Certificate& aCert

The X.509 certificate to be copied.

Return value

CX509Certificate*

The new X.509 certificate object.


NewLC()

static CX509Certificate* NewLC(const TDesC8& aBinaryData, TInt& aPos);

Description

Creates a new X.509 certificate object from the specified buffer containing the binary coded representation, starting at the specified offset, and puts a pointer to it onto the cleanup stack.

Parameters

const TDesC8& aBinaryData

The encoded binary representation.

const TInt& aPos

The offset position from which to start decoding.

Return value

CX509Certificate*

The new X.509 certificate object.


NewLC()

static CX509Certificate* NewLC(const TDesC8& aBinaryData);

Description

Creates a new X.509 certificate object from the specified buffer containing the binary coded representation, and puts a pointer to it onto the cleanup stack.

Iinitialises the object from its encoded binary form into an internal representation.

Parameters

const TDesC8& aBinaryData

The encoded binary representation.

Return value

CX509Certificate*

The new X.509 certificate object.


NewLC()

static CX509Certificate* NewLC(RReadStream& aStream);

Description

Creates a new X.509 certificate object from the specified read stream, and puts a pointer to it onto the cleanup stack.

Construction is from a stream.

Parameters

RReadStream& aStream

The read stream.

Return value

CX509Certificate*

The new X.509 certificate object.


NewLC()

static CX509Certificate* NewLC(const CCertStore& aStore, const CCertStoreEntry& aEntry);

Description

Creates a new X.509 certificate by loading the specified certificate store entry from the specified certificate store, and puts a pointer to it onto the cleanup stack.

Parameters

const CCertStore& aStore

The certificate store.

const CCertStoreEntry& aEntry

The certificate store entry.

Return value

CX509Certificate*

The new X.509 certificate object.


NewLC()

static CX509Certificate* NewLC(const CX509Certificate& aCert);

Description

Creates a new X.509 certificate object from an existing object.

This is equivalent to a copy constructor.

Parameters

const CX509Certificate& aCert

The X.509 certificate to be copied.

Return value

CX509Certificate*

The new X.509 certificate object.


~CX509Certificate()

~CX509Certificate();

Description

Destructor.

Frees all resources owned by the object, prior to its destruction.

[Top]


Member functions


IsEqualL()

TBool IsEqualL(const CX509Certificate& aCert) const;

Description

Tests whether the specified X.509 certificate is equal to this X.509 certificate.

X.509 certificates are equal if both the serial number and the issuer name are the same.

Parameters

const CX509Certificate& aCert

The X.509 certificate to be compared.

Return value

TBool

True, if the certificates are equal;false, otherwise.


Version()

TInt Version() const;

Description

Gets the version number.

Return value

TInt

The version number.


IssuerName()

const CX500DistinguishedName& IssuerName() const;

Description

Gets the issuer name.

Return value

CX500DistinguishedName&

The issuer name.


SubjectName()

const CX500DistinguishedName& SubjectName() const;

Description

Gets the subject name.

Return value

CX500DistinguishedName&

The subject name.


Extensions()

const CArrayPtrFlat<CX509CertExtension>& Extensions() const;

Description

Gets a reference to the X.509 certificate's extensions.

Return value

CArrayPtrFlatCX509CertExtension&

The certificate extensions.


Extension()

const CX509CertExtension* Extension(const TDesC& aExtensionName) const;

Description

Gets the certificate extension identified by the specified object identifier (OID).

Parameters

const TDesC& aExtensionName

The OID identifying the extension.

Return value

CX509CertExtension*

The certificate extension name.


InternalizeL()

void InternalizeL(RReadStream& aStream);

Description

Internalises the field data.

Parameters

RReadStream& aStream

Stream from which the the contents of the field should be internalised.