class CX500DistinguishedName : public CBase |
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.
Private Member Functions | |
---|---|
CX500DistinguishedName () | |
void | ConstructL (const CArrayPtr < CX520AttributeTypeAndValue > &) |
void | ConstructL (const TDesC8 &, TInt &) |
void | ConstructL ( RReadStream &) |
void | InternalizeL ( RReadStream &) |
Private Attributes | |
---|---|
CArrayPtrFlat < CX520AttributeTypeAndValue > * | iElements |
IMPORT_C | ~CX500DistinguishedName | ( | ) |
Destructor.
Frees all resources owned by the object, prior to its destruction.
void | ConstructL | ( | const CArrayPtr < CX520AttributeTypeAndValue > & | aElements | ) | [private] |
const CArrayPtr < CX520AttributeTypeAndValue > & aElements |
void | ConstructL | ( | const TDesC8 & | aBinaryData, |
TInt & | aPos | |||
) | [private] |
void | ConstructL | ( | RReadStream & | aStream | ) | [private] |
RReadStream & aStream |
IMPORT_C TInt | Count | ( | ) | const |
Gets the number of 'attribute type and value' objects contained by this Distinguished Name object.
IMPORT_C HBufC * | DisplayNameL | ( | ) | const |
Gets the decoded value for the common or organisation name.
IMPORT_C const CX520AttributeTypeAndValue & | Element | ( | TInt | aIndex | ) | const |
Gets a reference to specific 'attribute type and value' object as identified by the specified index.
TInt aIndex | The index number identifying the specific 'attribute type and value' object. This number is relative to zero. This value must be non-negative and less than the number of objects currently contained by this Distinguished Name object. |
IMPORT_C CASN1EncSequence * | EncodeASN1L | ( | ) | const |
Encodes a DN into an ASN.1 object tree.
See note in the description of EncodeASN1LC for the explanation of the resulting encoding tree format.
IMPORT_C CASN1EncSequence * | EncodeASN1LC | ( | ) | const |
Encodes a DN into an ASN.1 object tree.
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.
IMPORT_C TBool | ExactMatchL | ( | const CX500DistinguishedName & | aName | ) | const |
Compares the specified Distinguished Name object with this Distinguished Name object.
const CX500DistinguishedName & aName | The Distinguished Name object to be compared. |
IMPORT_C void | ExternalizeL | ( | RWriteStream & | aStream | ) | const |
Externalises an object of this class to a write stream.
The presence of this function means that the standard templated operator<<() can be used to externalise objects of this class.
RWriteStream & aStream | Stream to which the object should be externalised. |
IMPORT_C HBufC * | ExtractFieldL | ( | const TDesC & | aFieldName | ) | const |
Gets the decoded value associated with the specified field/attribute name, from the Distinguished Name.
const TDesC & aFieldName | The field name. |
void | InternalizeL | ( | RReadStream & | aStream | ) | [private] |
RReadStream & aStream |
IMPORT_C TBool | IsWithinSubtreeL | ( | const CX500DistinguishedName & | aName | ) | const |
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.
const CX500DistinguishedName & aName | The Distinguished Name object to be compared. |
IMPORT_C TBool | MatchElementL | ( | const CX520AttributeTypeAndValue & | aElement | ) | const |
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() function.
const CX520AttributeTypeAndValue & aElement | The 'attribute type and value' object to be checked. |
IMPORT_C CX500DistinguishedName * | NewL | ( | const TDesC8 & | aBinaryData, |
TInt & | aPos | |||
) | [static] |
Creates a new Distinguished Name object from the specified buffer containing the encoded binary representation, starting at the specified offset.
IMPORT_C CX500DistinguishedName * | NewL | ( | const TDesC8 & | aBinaryData | ) | [static] |
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.
const TDesC8 & aBinaryData | The encoded binary representation. |
IMPORT_C CX500DistinguishedName * | NewL | ( | RReadStream & | aStream | ) | [static] |
Creates a new Distinguished Name object from the specified read stream.
Construction is from a stream.
RReadStream & aStream | Stream from which the contents should be internalised. |
IMPORT_C CX500DistinguishedName * | NewL | ( | const CArrayPtr < CX520AttributeTypeAndValue > & | aElements | ) | [static] |
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.
const CArrayPtr < CX520AttributeTypeAndValue > & aElements | The array of 'attribute type and value' objects to be copied. |
IMPORT_C CX500DistinguishedName * | NewL | ( | const CX500DistinguishedName & | aName | ) | [static] |
Creates a new Distinguished Name object from an existing object.
This is equivalent to a copy constructor.
const CX500DistinguishedName & aName | The Distinguished Name object to be copied. |
IMPORT_C CX500DistinguishedName * | NewLC | ( | const TDesC8 & | aBinaryData, |
TInt & | aPos | |||
) | [static] |
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.
IMPORT_C CX500DistinguishedName * | NewLC | ( | const TDesC8 & | aBinaryData | ) | [static] |
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.
const TDesC8 & aBinaryData | The encoded binary representation. |
IMPORT_C CX500DistinguishedName * | NewLC | ( | RReadStream & | aStream | ) | [static] |
Creates a new Distinguished Name object from the specified read stream, and puts a pointer to it onto the cleanup stack.
RReadStream & aStream | Stream from which the contents should be internalised. |
IMPORT_C CX500DistinguishedName * | NewLC | ( | const CArrayPtr < CX520AttributeTypeAndValue > & | aElements | ) | [static] |
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.
const CArrayPtr < CX520AttributeTypeAndValue > & aElements | The array of 'attribute type and value' objects to be copied. |
IMPORT_C CX500DistinguishedName * | NewLC | ( | const CX500DistinguishedName & | aName | ) | [static] |
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.
const CX500DistinguishedName & aName | The Distinguished Name object to be copied. |
CArrayPtrFlat < CX520AttributeTypeAndValue > * | iElements | [private] |
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.