Class CX509CertExtension

class CX509CertExtension : public CBase;

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

• CBase - Base class for all classes to be instantiated on the heap.

• CX509CertExtension - A generic X.509 certificate extension.

Members

Defined in CX509CertExtension:

• Critical()constTests whether certificate processing code must process this extension for certif...
• Data()constGets the encoded binary representation of the specific extension.
• EncodeASN1DERLC()constCreates and returns a DER encoded X.509 certificate extension object in the form...
• Id()constGets the Object Identifier (OID) of the certficate extension.
• NewL(const CX509CertExtension &)Creates a new generic X.509 certificate extension object from an existing object...
• NewL(const TDesC &,const TBool,const TDesC8 &)Creates a new generic X.509 certificate extension object from the specified exte...
• NewL(const TDesC8 &)Creates a new generic X.509 certificate extension object from the specified buff...
• NewL(const TDesC8 &,TInt &)Creates a new generic X.509 certificate extension object from the specified buff...
• NewLC(const CX509CertExtension &)Creates a new generic X.509 certificate extension object from an existing object...
• NewLC(const TDesC &,const TBool,const TDesC8 &)Creates a new generic X.509 certificate extension object from the specified exte...
• NewLC(const TDesC8 &)Creates a new generic X.509 certificate extension object from the specified buff...
• NewLC(const TDesC8 &,TInt &)Creates a new generic X.509 certificate extension object from the specified buff...
• ~CX509CertExtension()Destructor.

Inherited from CBase:

• Delete(CBase *)Deletes the specified object.
• Extension_(TUint,TAny *&,TAny *)Extension function
• operator new(TUint)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TAny *)Initialises the object to binary zeroes.
• operator new(TUint,TLeave)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TLeave,TUint)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TUint)Allocates the object from the heap and then initialises its contents to binary z...

IMPORT_C 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

Return value

IMPORT_C 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

Return value

IMPORT_C 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

Return value

IMPORT_C 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

Return value

IMPORT_C 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

Return value

IMPORT_C 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

Return value

IMPORT_C static CX509CertExtension* NewL(const TDesC &aCertExtOID, const TBool aCritical, const TDesC8 &aCertExtValue);

Description

Creates a new generic X.509 certificate extension object from the specified extension object id, the critcal flag and the extension data.

Parameters

Return value

IMPORT_C static CX509CertExtension* NewLC(const TDesC &aCertExtOID, const TBool aCritical, const TDesC8 &aCertExtValue);

Description

Creates a new generic X.509 certificate extension object from the specified extension object id, the critcal flag and the extension data, and puts a pointer to it onto the cleanup stack.

Parameters

Return value

IMPORT_C ~CX509CertExtension();

Description

Destructor.

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

IMPORT_C TBool Critical() const;

Description

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

Return value

IMPORT_C TPtrC Id() const;

Description

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

Return value

IMPORT_C TPtrC8 Data() const;

Description

Gets the encoded binary representation of the specific extension.

Return value

IMPORT_C CASN1EncSequence* EncodeASN1DERLC() const;

Description

Creates and returns a DER encoded X.509 certificate extension object in the form of a ASN.1 Sequence and puts it onto the cleanup stack. This method can be called repeatedly to get copies of the sequence.

Return value