Symbian
 Developer Library

DEVELOPER LIBRARY

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



Location: x509cert.h
Link against: x509.lib

Class CX509CertExtension

CX509CertExtension

Support

Supported from 6.0

Description

A generic X.509 certificate extension.

The creation of a generic extension is the first step in the creation of a specific extension. Client code gets the decoded Object Identifier (OID) encapsulated by an instance of this class and uses it to create the specific extension.

Consists of an any-defined-by structure along with a boolean flag saying whether the extension is critical or not.

Derivation

CBaseBase class for all classes to be instantiated on the heap
CX509CertExtensionA generic X.509 certificate extension

Defined in CX509CertExtension:
Critical(), Data(), Id(), NewL(), NewL(), NewL(), NewLC(), NewLC(), NewLC(), ~CX509CertExtension()

Inherited from CBase:
operator new()


Construction and destruction


NewL()

static CX509CertExtension* NewL(const CX509CertExtension& aExtension);

Description

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

This is equivalent to a copy constructor.

Parameters

const CX509CertExtension& aExtension

The generic certificate extension to be copied.

Return value

CX509CertExtension*

The new generic certificate extension object.


NewL()

static CX509CertExtension* NewL(const TDesC8& aBinaryData);

Description

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

Parameters

const TDesC8& aBinaryData

The encoded binary representation.

Return value

CX509CertExtension*

The new generic X.509 certificate extension object.


NewL()

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

Description

Creates a new generic X.509 certificate extension 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

CX509CertExtension*

The new generic X.509 certificate extension object.


NewLC()

static CX509CertExtension* NewLC(const TDesC8& aBinaryData);

Description

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

Parameters

const TDesC8& aBinaryData

The encoded binary representation.

Return value

CX509CertExtension*

The new generic X.509 certificate extension object.


NewLC()

static CX509CertExtension* NewLC(const CX509CertExtension& aExtension);

Description

Creates a new generic X.509 certificate extension object from an existing object, and puts a pointer to it onto the cleanup stack.

This is equivalent to a copy constructor.

Parameters

const CX509CertExtension& aExtension

The generic certificate extension to be copied.

Return value

CX509CertExtension*

The new generic X.509 certificate extension object.


NewLC()

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

Description

Creates a new generic X.509 certificate extension 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

CX509CertExtension*

The new generic X.509 certificate extension object.


~CX509CertExtension()

~CX509CertExtension();

Description

Destructor.

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

[Top]


Member functions


Critical()

TBool Critical() const;

Description

Tests whether certificate processing code must process this extension for certificate validation to succeed.

Return value

TBool

True, if this extension must be processed for validation to succeed; false, otherwise.


Id()

TPtrC Id() const;   

Description

Gets the Object Identifier (OID) of the certficate extension.

Return value

TPtrC

The OID of the certficate extension.


Data()

TPtrC8 Data() const;

Description

Gets the encoded binary representation of the specific extension.

Return value

TPtrC8

A pointer descriptor representing the specific extension.