Class CX509AltNameExt

class CX509AltNameExt : public CX509ExtensionBase;

Description

An X.509 certificate extension that defines an alternate name.

It appears as an Issuer Alt Name extension or a Subject Alt Name extension and is used to contain extra identifying information that will not fit into a Distinguished Name.

It consists of an array of X.509 General Names.

Derivation

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

• CX509ExtensionBase - A certificate extension base class

• CX509AltNameExt - An X.509 certificate extension that defines an alternate name

Members

Defined in CX509AltNameExt:
AltName(), DoConstructL(), Match(), NewL(), NewL(), NewLC(), NewLC()

Inherited from CBase:
Delete(), Extension_(), operator new()

Inherited from CX509ExtensionBase:
ConstructL()

static IMPORT_C CX509AltNameExt *NewL(const TDesC8 &aBinaryData);

Description

Creates a new CX509AltNameExt object from the specified buffer containing the binary coded representation.

Parameters

const TDesC8 &aBinaryData The encoded binary representation.

Return value

CX509AltNameExt * The new CX509AltNameExt object.

static IMPORT_C CX509AltNameExt *NewLC(const TDesC8 &aBinaryData);

Description

Creates a new CX509AltNameExt 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

CX509AltNameExt * The new CX509AltNameExt object.

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

Description

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

Parameters

const TDesC8 &aBinaryData The encoded binary representation. TInt &aPos The offset position from which to start decoding.

Return value

CX509AltNameExt * The new CX509AltNameExt object.

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

Description

Creates a new CX509AltNameExt 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. TInt &aPos The offset position from which to start decoding.

Return value

CX509AltNameExt * The new CX509AltNameExt object.

IMPORT_C const CArrayPtrFlat< CX509GeneralName > &AltName() const;

Description

Gets a reference to the array of general names that forms the alternate name extension.

Return value

const CArrayPtrFlat< CX509GeneralName > & The array of general names.

IMPORT_C TBool Match(const CX509AltNameExt &aExt) const;

Description

Checks whether the corressponding elements of two equally sized arrays of X.509 general names match.

Parameters

const CX509AltNameExt &aExt An X.509 certificate extension object that defines an alternate name.

Return value

TBool TRUE if all the elements in the arrays match.

private: virtual void DoConstructL(const TDesC8 &aBinaryData, TInt &aPos);

Description

Implementation for second-phase construction.

This is called by ConstructL().

Parameters

const TDesC8 &aBinaryData The encoded binary representation. This is the same as passed to ConstructL(). TInt &aPos The position from which to start decoding. Note that the value passed points, in effect, to the content, by passing the header data.