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()constGets a reference to the array of general names that forms the alternate name ext...
• DoConstructL(const TDesC8 &,TInt &)Implementation for second-phase construction.
• Match(const CX509AltNameExt &)constChecks whether the corressponding elements of two equally sized arrays of X.509 ...
• NewL(const TDesC8 &)Creates a new CX509AltNameExt object from the specified buffer containing the bi...
• NewL(const TDesC8 &,TInt &)Creates a new CX509AltNameExt object from the specified buffer containing the bi...
• NewLC(const TDesC8 &)Creates a new CX509AltNameExt object from the specified buffer containing the bi...
• NewLC(const TDesC8 &,TInt &)Creates a new CX509AltNameExt object from the specified buffer containing the bi...
• ~CX509AltNameExt()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...

Inherited from CX509ExtensionBase:

• ConstructL(const TDesC8 &,TInt &)Second-phase constructor.

IMPORT_C static 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.

IMPORT_C static 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.

IMPORT_C static 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.

IMPORT_C static 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.

virtual ~CX509AltNameExt();

Description

Destructor.

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

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 CX509ExtensionBase::ConstructL(const TDesC8 &,TInt &).

Parameters

const TDesC8 &aBinaryData The encoded binary representation. This is the same as passed to CX509ExtensionBase::ConstructL(const TDesC8 &,TInt &). 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.