Class CX509NameConstraintsExt

class CX509NameConstraintsExt : public CX509ExtensionBase;

Description

An X.509 certificate extension that defines constraints on an entity's name.

This extension allows Certification Authorities to restrict or prevent the issuing of certificates to entities whose names lie within a defined name space.

Derivation

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

• CX509ExtensionBase - A certificate extension base class.

• CX509NameConstraintsExt - An X.509 certificate extension that defines constraints on an entity's name.

Members

Defined in CX509NameConstraintsExt:

• DoConstructL(const TDesC8 &,TInt &)Implementation for second-phase construction.
• ExcludedSubtrees()constGets a reference to the array of exclusion subtree names.
• NewL(const TDesC8 &)Creates a new CX509NameConstraintsExt object from the specified buffer containin...
• NewL(const TDesC8 &,TInt &)Creates a new CX509NameConstraintsExt object from the specified buffer containin...
• NewLC(const TDesC8 &)Creates a new CX509NameConstraintsExt object from the specified buffer containin...
• NewLC(const TDesC8 &,TInt &)Creates a new CX509NameConstraintsExt object from the specified buffer containin...
• PermittedSubtrees()constGets a reference to the array of permitted subtree names.
• ~CX509NameConstraintsExt()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 CX509NameConstraintsExt* NewL(const TDesC8 &aBinaryData);

Description

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

Parameters

const TDesC8 &aBinaryData The encoded binary representation.

Return value

CX509NameConstraintsExt * The new CX509NameConstraintsExt object.

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

Description

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

CX509NameConstraintsExt * The new CX509NameConstraintsExt object.

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

Description

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

CX509NameConstraintsExt * The new CX509NameConstraintsExt object.

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

Description

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

CX509NameConstraintsExt * The new CX509NameConstraintsExt object.

IMPORT_C ~CX509NameConstraintsExt();

Description

Destructor.

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

IMPORT_C const CArrayPtrFlat< CX509GeneralSubtree >& ExcludedSubtrees() const;

Description

Gets a reference to the array of exclusion subtree names.

No certificates after this one may contain names within the subtrees specified.

Return value

const CArrayPtrFlat< CX509GeneralSubtree > & The excluded subtrees.

IMPORT_C const CArrayPtrFlat< CX509GeneralSubtree >& PermittedSubtrees() const;

Description

Gets a reference to the array of permitted subtree names.

All certificates after this one must contain names within the subtrees specified.

Return value

const CArrayPtrFlat< CX509GeneralSubtree > & The permitted subtrees.

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.