Class CX500DistinguishedName

class CX500DistinguishedName : public CBase;

Description

Holds the Distinguished Name of a subject.

A collection of 'attribute type and value' objects, as defined by the X.520 standard.

The name used in X.509 certificates is the X.500 Distinguished Name, which describes a path through an X.500 Directory Information Tree.

A Distinguished Name is a series of name-value pairs that uniquely identify an entity, i.e. the certificate subject.

Derivation

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

• CX500DistinguishedName - Holds the Distinguished Name of a subject.

Members

Defined in CX500DistinguishedName:

• Count()constGets the number of 'attribute type and value' objects contained by this Distingu...
• DisplayNameL()constGets the decoded value for the common or organisation name.
• Element(TInt)constGets a reference to specific 'attribute type and value' object as identified by ...
• EncodeASN1L()constEncodes a DN into an ASN.1 object tree.
• EncodeASN1LC()constEncodes a DN into an ASN.1 object tree.
• ExactMatchL(const CX500DistinguishedName &)constCompares the specified Distinguished Name object with this Distinguished Name ob...
• ExternalizeL(RWriteStream &)constExternalises an object of this class to a write stream.
• ExtractFieldL(const TDesC &)constGets the decoded value associated with the specified field/attribute name, from ...
• IsWithinSubtreeL(const CX500DistinguishedName &)constTests whether all 'attribute type and value' objects contained in the specified ...
• MatchElementL(const CX520AttributeTypeAndValue &)constTests whether this Distinguished Name object contains the specified 'attribute t...
• NewL(RReadStream &)Creates a new Distinguished Name object from the specified read stream.
• NewL(const CArrayPtr< CX520AttributeTypeAndValue > &)Creates a new Distinguished Name object from the specified array of 'attribute t...
• NewL(const CX500DistinguishedName &)Creates a new Distinguished Name object from an existing object.
• NewL(const TDesC8 &)Creates a new Distinguished Name object from the specified buffer containing the...
• NewL(const TDesC8 &,TInt &)Creates a new Distinguished Name object from the specified buffer containing the...
• NewLC(RReadStream &)Creates a new Distinguished Name object from the specified read stream, and puts...
• NewLC(const CArrayPtr< CX520AttributeTypeAndValue > &)Creates a new Distinguished Name object from the specified array of 'attribute t...
• NewLC(const CX500DistinguishedName &)Creates a new Distinguished Name object from an existing object, and puts a poin...
• NewLC(const TDesC8 &)Creates a new Distinguished Name object from the specified buffer containing the...
• NewLC(const TDesC8 &,TInt &)Creates a new Distinguished Name object from the specified buffer containing the...
• ~CX500DistinguishedName()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 CX500DistinguishedName* NewL(const TDesC8 &aBinaryData, TInt &aPos);

Description

Creates a new Distinguished Name object from the specified buffer containing the encoded binary representation, starting at the specified offset.

Parameters

Return value

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

Description

Creates a new Distinguished Name object from the specified buffer containing the encoded binary representation, starting at the specified offset, and puts a pointer to it onto the cleanup stack.

Parameters

Return value

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

Description

Creates a new Distinguished Name object from the specified buffer containing the encoded binary representation.

Initialises the object from its encoded binary form into an internal representation.

Parameters

Return value

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

Description

Creates a new Distinguished Name object from the specified buffer containing the encoded binary representation, and puts a pointer to it onto the cleanup stack.

Initialises the object from its encoded binary form into an internal representation.

Parameters

Return value

IMPORT_C static CX500DistinguishedName* NewL(RReadStream &aStream);

Description

Creates a new Distinguished Name object from the specified read stream.

Construction is from a stream.

Parameters

Return value

IMPORT_C static CX500DistinguishedName* NewLC(RReadStream &aStream);

Description

Creates a new Distinguished Name object from the specified read stream, and puts a pointer to it onto the cleanup stack.

Parameters

Return value

IMPORT_C static CX500DistinguishedName* NewL(const CArrayPtr< CX520AttributeTypeAndValue > &aElements);

Description

Creates a new Distinguished Name object from the specified array of 'attribute type and value' objects.

The elements of the specified array are copied into this object.

Parameters

Return value

IMPORT_C static CX500DistinguishedName* NewLC(const CArrayPtr< CX520AttributeTypeAndValue > &aElements);

Description

Creates a new Distinguished Name object from the specified array of 'attribute type and value' objects, and puts a pointer to it onto the cleanup stack.

The elements of the specified array are copied into this object.

Parameters

Return value

IMPORT_C static CX500DistinguishedName* NewL(const CX500DistinguishedName &aName);

Description

Creates a new Distinguished Name object from an existing object.

This is equivalent to a copy constructor.

Parameters

Return value

IMPORT_C static CX500DistinguishedName* NewLC(const CX500DistinguishedName &aName);

Description

Creates a new Distinguished Name 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 ~CX500DistinguishedName();

Description

Destructor.

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

IMPORT_C void ExternalizeL(RWriteStream &aStream) const;

Description

Externalises an object of this class to a write stream.

The presence of this function means that the standard templated operator<<(RWriteStream &,const T &) can be used to externalise objects of this class.

Parameters

IMPORT_C TInt Count() const;

Description

Gets the number of 'attribute type and value' objects contained by this Distinguished Name object.

Return value

IMPORT_C const CX520AttributeTypeAndValue& Element(TInt aIndex) const;

Description

Gets a reference to specific 'attribute type and value' object as identified by the specified index.

Parameters

Return value

IMPORT_C TBool ExactMatchL(const CX500DistinguishedName &aName) const;

Description

Compares the specified Distinguished Name object with this Distinguished Name object.

Parameters

Return value

See also:

• CX520AttributeTypeAndValue::ExactMatchL(const CX520AttributeTypeAndValue &)constCompares the attribute type and decoded value of the specified object.

IMPORT_C TBool IsWithinSubtreeL(const CX500DistinguishedName &aName) const;

Description

Tests whether all 'attribute type and value' objects contained in the specified Distinguished Name object are also contained within this Distinguished Name object.

This function checks if the elements of iElements are a superset of the fields in aName.

Parameters

Return value

IMPORT_C TBool MatchElementL(const CX520AttributeTypeAndValue &aElement) const;

Description

Tests whether this Distinguished Name object contains the specified 'attribute type and value' object.

This function compares each of the elements in iElements with aElement. The comparison is made by the CX520AttributeTypeAndValue::ExactMatchL(const CX520AttributeTypeAndValue &)const function.

Parameters

Return value

IMPORT_C HBufC* ExtractFieldL(const TDesC &aFieldName) const;

Description

Gets the decoded value associated with the specified field/attribute name, from the Distinguished Name.

Parameters

Return value

IMPORT_C HBufC* DisplayNameL() const;

Description

Gets the decoded value for the common or organisation name.

Return value

IMPORT_C CASN1EncSequence* EncodeASN1LC() const;

Description

Encodes a DN into an ASN.1 object tree.

Note that the tree has the following format:

         SEQUENCE-OF
             SET-OF
                 SEQUENCE-OF
                     OID
                     value (usually OCTET STRING)
             ...

A SEQUENCE-OF object with a changed tag is used instead of a SET-OF object. This should be all right as long as it contains only one child, because otherwise child order in a SET-OF becomes important.

This function does not introduce an additional dependency on ASN1 library because X500 library already depends on it -- the attribute type/value class stores and manipulated ASN.1 encodings as its values.

Return value

IMPORT_C CASN1EncSequence* EncodeASN1L() const;

Description

Encodes a DN into an ASN.1 object tree.

See note in the description of CX500DistinguishedName::EncodeASN1LC()const for the explanation of the resulting encoding tree format.

Return value