Symbian
 Developer Library

DEVELOPER LIBRARY

[Index] [Glossary] [Previous] [Next]



Location: x509gn.h
Link against: x509.lib

Class CX509GeneralName

CX509GeneralName

Support

Supported from 6.0

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 john.doe@symbian.com'. Both names are valid subtrees but only the second is a valid RFC822 name.

Derivation

CBaseBase class for all classes to be instantiated on the heap
CX509GeneralNameDefines a general name

Defined in CX509GeneralName:
Data(), ExactMatch(), NewL(), NewL(), NewL(), NewLC(), NewLC(), NewLC(), Tag(), ~CX509GeneralName()

Inherited from CBase:
operator new()


Construction and destruction


NewL()

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.


NewL()

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.

const TInt& aPos

The offset position from which to start decoding.

Return value

CX509GeneralName*

The new general name object.


NewL()

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.


NewLC()

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.

Iinitialises 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.


NewLC()

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.


NewLC()

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.

Parameters

const TDesC8& aBinaryData

The encoded binary representation.

const TInt& aPos

The offset position from which to start decoding.

Return value

CX509GeneralName*

The new general name object.


~CX509GeneralName()

~CX509GeneralName();

Description

Destructor.

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

[Top]


Member functions


Tag()

TGNType Tag() const;

Description

Gets the type tag.

Return value

TGNType

The type tag.


Data()

TPtrC8 Data() const;

Description

Gets the name.

Return value

TPtrC8

A pointer descriptor representing the name.


ExactMatch()

TBool ExactMatch(const CX509GeneralName& aName) const;

Description

This function is not implemented and always returns false.