Class CX509GeneralName

class CX509GeneralName : public CBase;

Description

Defines a general name.

The class contains a tag and a name whose form depends on the value of that tag.

When a General Name is included as part of a Name Constraints Extension, the values need not be complete names but may be simply subtrees.

For example, 'symbian.com' instead of [email protected]'. Both names are valid subtrees but only the second is a valid RFC822 name.

Derivation

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

• CX509GeneralName - Defines a general name.

Members

Defined in CX509GeneralName:

• Data()constGets the name.
• ExactMatch(const CX509GeneralName &)constDummy Function which always returns EFalse.
• NewL(const CX509GeneralName &)Creates a new general name object from an existing object.
• NewL(const TDesC8 &)Creates a new general name object from the specified buffer containing the binar...
• NewL(const TDesC8 &,TInt &)Creates a new general name object from the specified buffer containing the binar...
• NewLC(const CX509GeneralName &)Creates a new general name object from an existing object, and puts a pointer to...
• NewLC(const TDesC8 &)Creates a new general name object from the specified buffer containing the binar...
• NewLC(const TDesC8 &,TInt &)Creates a new general name object from the specified buffer containing the binar...
• Tag()constGets the type tag.
• ~CX509GeneralName()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 CX509GeneralName* NewL(const TDesC8 &aBinaryData);

Description

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

Parameters

const TDesC8 &aBinaryData The encoded binary representation.

Return value

CX509GeneralName * The new general name object.

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

Description

Creates a new general name object from the specified buffer containing the binary coded representation, and puts a pointer to it onto the cleanup stack.

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

Parameters

const TDesC8 &aBinaryData The encoded binary representation.

Return value

CX509GeneralName * The new general name object.

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

Description

Creates a new general name 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

CX509GeneralName * The new general name object.

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

Description

Creates a new general name 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.

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

Parameters

const TDesC8 &aBinaryData The encoded binary representation. TInt &aPos The offset position from which to start decoding.

Return value

CX509GeneralName * The new general name object.

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

Description

Creates a new general name object from an existing object.

This is equivalent to a copy constructor.

Parameters

const CX509GeneralName &aName The general name object to be copied.

Return value

CX509GeneralName * The new general name object.

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

Description

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

This is equivalent to a copy constructor.

Parameters

const CX509GeneralName &aName The general name object to be copied.

Return value

CX509GeneralName * The new general name object.

IMPORT_C ~CX509GeneralName();

Description

Destructor.

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

IMPORT_C TGNType Tag() const;

Description

Gets the type tag.

Return value

TGNType The type tag.

IMPORT_C TPtrC8 Data() const;

Description

Gets the name.

Return value

TPtrC8 A pointer descriptor representing the name.

IMPORT_C TBool ExactMatch(const CX509GeneralName &aName) const;

Description

Dummy Function which always returns EFalse.

Parameters

const CX509GeneralName &aName The general name object to be copied.

Return value

TBool EFalse.