CX520AttributeTypeAndValue Class Reference

#include <x520ava.h>

Link against: x500.lib

class CX520AttributeTypeAndValue : public CBase

Inherits from

  • CX520AttributeTypeAndValue

Detailed Description

Contains an attribute type and a value, as defined by the X.520 standard.

A Distinguished Name object, as defined by the X.500 standard, consists of a sequence of these objects.

Since
v6.0

Constructor & Destructor Documentation

~CX520AttributeTypeAndValue ( )

IMPORT_C~CX520AttributeTypeAndValue()

Destructor.

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

Member Function Documentation

EncodeASN1L ( )

IMPORT_C CASN1EncSequence *EncodeASN1L()const

Encodes the contents into an ASN.1 sequence object.

Useful to insert attribute type/value pairs into other ASN.1 encoding trees.

Return Value
New ASN.1 sequence object containing attribute type/value pair in for of an OID and an octet string.

EncodeASN1LC ( )

IMPORT_C CASN1EncSequence *EncodeASN1LC()const

Encodes the contents into an ASN.1 sequence object.

This is useful to insert attribute type/value pairs into other ASN.1 encoding trees.

Return Value
New ASN.1 sequence object containing attribute type/value pair in for of an OID and an octet string; leaves the returned object on the cleanup stack.

EncodedValue ( )

IMPORT_C const TPtrC8EncodedValue()const

Gets the encoded attribute value of the object.

Return Value
The pointer descriptor representing the encoded attribute value.

ExactMatchL ( const CX520AttributeTypeAndValue & )

IMPORT_C TBoolExactMatchL(const CX520AttributeTypeAndValue &aElement)const [virtual]

Compares the attribute type and decoded value of the specified object.

Parameters
aElementThe CX520AttributeTypeAndValue object to be compared.
Return Value
ETrue, if the attribute types and the decoded values match; EFalse, otherwise.

ExternalizeL ( RWriteStream & )

voidExternalizeL(RWriteStream &aStream)const [virtual]

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.

Parameters
aStreamStream to which the object should be externalised.

NewL ( const TDesC8 & )

IMPORT_C CX520AttributeTypeAndValue *NewL(const TDesC8 &aBinaryData)[static]

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

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

Parameters
aBinaryDataThe encoded binary representation.
Return Value
The new CX520AttributeTypeAndValue object.

NewL ( const TDesC8 &, TInt & )

IMPORT_C CX520AttributeTypeAndValue *NewL(const TDesC8 &aBinaryData,
TInt &aPos
)[static]

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

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

Parameters
aBinaryDataThe encoded binary representation.
aPosThe offset position from which to start decoding.
Return Value
The new CX520AttributeTypeAndValue object.

NewL ( const CX520AttributeTypeAndValue & )

IMPORT_C CX520AttributeTypeAndValue *NewL(const CX520AttributeTypeAndValue &aPair)[static]

Creates a new CX520AttributeTypeAndValue object from an existing object.

This is equivalent to a copy constructor.

Parameters
aPairThe CX520AttributeTypeAndValue object.
Return Value
The new CX520AttributeTypeAndValue object.

NewL ( RReadStream & )

IMPORT_C CX520AttributeTypeAndValue *NewL(RReadStream &aStream)[static]

Creates a new CX520AttributeTypeAndValue object from the specified read stream.

Parameters
aStreamStream from which the object is to be internalised.
Return Value
The new CX520AttributeTypeAndValue object.

NewL ( TAttributeType, const TDesC8 & )

IMPORT_C CX520AttributeTypeAndValue *NewL(TAttributeTypeaType,
const TDesC8 &aValue
)[static]

Creates a new CX520AttributeTypeAndValue object from an attribute type and value.

Allocates and initializes a new attribute-value pair object from type and value.

See also: CX520AttributeTypeAndValue::NewLC

Parameters
aTypeType of the value (see TAttributeType enum).
aValueString value of the attribute.
Return Value
New CX520AttributeTypeAndValue objectPointer to a newly allocated and initialized attribute-value pair.

NewLC ( const TDesC8 & )

IMPORT_C CX520AttributeTypeAndValue *NewLC(const TDesC8 &aBinaryData)[static]

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

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

Parameters
aBinaryDataThe encoded binary representation.
Return Value
The new CX520AttributeTypeAndValue object.

NewLC ( const TDesC8 &, TInt & )

IMPORT_C CX520AttributeTypeAndValue *NewLC(const TDesC8 &aBinaryData,
TInt &aPos
)[static]

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

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

Parameters
aBinaryDataThe encoded binary representation.
aPosThe offset position from which to start decoding.
Return Value
The new CX520AttributeTypeAndValue object.

NewLC ( const CX520AttributeTypeAndValue & )

IMPORT_C CX520AttributeTypeAndValue *NewLC(const CX520AttributeTypeAndValue &aPair)[static]

Creates a new CX520AttributeTypeAndValue object from an existing object, and puts a pointer to the new object onto the cleanup stack.

This is equivalent to a copy constructor.

Parameters
aPairThe CX520AttributeTypeAndValue object.
Return Value
The new CX520AttributeTypeAndValue object.

NewLC ( RReadStream & )

IMPORT_C CX520AttributeTypeAndValue *NewLC(RReadStream &aStream)[static]

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

Parameters
aStreamStream from which the object is to be internalised.
Return Value
The new CX520AttributeTypeAndValue object.

NewLC ( TAttributeType, const TDesC8 & )

IMPORT_C CX520AttributeTypeAndValue *NewLC(TAttributeTypeaType,
const TDesC8 &aValue
)[static]

Creates a new CX520AttributeTypeAndValue object from an attribute type and value.

Allocates and initializes a new attribute-value pair object from type and value. Pushes the newly allocated object onto the cleanup stack.

See also: CX520AttributeTypeAndValue::NewL

Parameters
aTypeType of the value (see TAttributeType enum).
aValueString value of the attribute.
Return Value
New CX520AttributeTypeAndValue object on the cleanup stackPointer to a newly allocated and initialized attribute-value pair.

Type ( )

IMPORT_C const TPtrCType()const

Gets the encoded attribute type of the object.

Return Value
A pointer descriptor representing the encoded attribute type.

ValueL ( )

IMPORT_C HBufC *ValueL()const [virtual]

Gets the decoded value.

Return Value
A heap descriptor containing the decoded value.