Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]



Location: wtlsnames.h
Link against: wtlscert.lib

Class CWTLSName

class CWTLSName : public CBase;

Description

Stores the type of a WTLS name and the underlying encoding of the type.

Derivation

Members

Defined in CWTLSName:
DisplayNameL(), ExactMatchL(), NameData(), NameType(), NewL(), NewL(), NewL(), NewLC(), NewLC(), NewLC(), ~CWTLSName()

Inherited from CBase:
Delete(), Extension_(), operator new()


Construction and destruction


NewL()

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

Description

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

Parameters

const TDesC8 &aBinaryData

The encoded binary representation.

Return value

CWTLSName *

The new CWTLSName object.


NewLC()

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

Description

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

Parameters

const TDesC8 &aBinaryData

The encoded binary representation.

Return value

CWTLSName *

The new CWTLSName object.


NewL()

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

Description

Creates a new CWTLSName 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. It specifies an offset into the descriptor, and is updated to the position at the end of the object.

Return value

CWTLSName *

The new CWTLSName object.


NewLC()

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

Description

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

TInt &aPos

The offset position from which to start decoding. It specifies an offset into the descriptor, and is updated to the position at the end of the object.

Return value

CWTLSName *

The new CWTLSName object.


NewL()

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

Description

Creates a new CWTLSName object from an existing one.

Parameters

const CWTLSName &aName

An existing CWTLSName object.

Return value

CWTLSName *

The new CWTLSName object.


NewLC()

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

Description

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

Parameters

const CWTLSName &aName

An existing CWTLSName object.

Return value

CWTLSName *

The new CWTLSName object.


~CWTLSName()

IMPORT_C ~CWTLSName();

Description

Destructor.

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

[Top]


Member functions


ExactMatchL()

IMPORT_C TBool ExactMatchL(const CWTLSName &aName) const;

Description

Performs a simple byte compare between this WTLS name and a specified WTLS name.

Needed for the constructing/validating of certificate chains.

Parameters

const CWTLSName &aName

An existing CWTLSName object.

Return value

TBool

ETrue, if the WTLS names match; EFalse, otherwise.


NameType()

IMPORT_C TWTLSNameType NameType() const;

Description

Gets the type of the WTLS name.

Return value

TWTLSNameType

Type of WTLS name form.


NameData()

IMPORT_C TPtrC8 NameData() const;

Description

Gets the encoding of the underlying type of WTLS name.

Return value

TPtrC8

Pointer descriptor representing the encoding of the WTLS name type.


DisplayNameL()

IMPORT_C HBufC *DisplayNameL() const;

Description

Gets the decoded value for the common or organisation name.

Provides the functionality required by the CCertificate::IssuerL() and SubjectL() functions.

Return value

HBufC *

A heap descriptor containing the decoded value of the common or organisation name.