CWTLSName Class Reference

#include <wtlsnames.h>

Link against: wtlscert.lib

class CWTLSName : public CBase

Inherits from

CWTLSName
- CBase

Public Member Functions
	~CWTLSName()
IMPORT_C HBufC *	DisplayNameL()
IMPORT_C TBool	ExactMatchL(const CWTLSName &)
IMPORT_C TPtrC8	NameData()
IMPORT_C TWTLSNameType	NameType()
IMPORT_C CWTLSName *	NewL(const TDesC8 &)
IMPORT_C CWTLSName *	NewL(const TDesC8 &, TInt &)
IMPORT_C CWTLSName *	NewL(const CWTLSName &)
IMPORT_C CWTLSName *	NewLC(const TDesC8 &)
IMPORT_C CWTLSName *	NewLC(const TDesC8 &, TInt &)
IMPORT_C CWTLSName *	NewLC(const CWTLSName &)

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()

Detailed Description

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

Constructor & Destructor Documentation

~CWTLSName ( )

IMPORT_C

~CWTLSName

(

)

Destructor.

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

Member Function Documentation

DisplayNameL ( )

IMPORT_C HBufC *

DisplayNameL

(

)

const

Gets the decoded value for the common or organisation name.

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

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

ExactMatchL ( const CWTLSName & )

IMPORT_C TBool

ExactMatchL

(

const CWTLSName &

aName

)

const

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

Needed for the constructing/validating of certificate chains.

Parameters
aName	An existing CWTLSName object.

Return Value: ETrue, if the WTLS names match; EFalse, otherwise.

NameData ( )

IMPORT_C TPtrC8

NameData

(

)

const

Gets the encoding of the underlying type of WTLS name.

Return Value: Pointer descriptor representing the encoding of the WTLS name type.

NameType ( )

IMPORT_C TWTLSNameType

NameType

(

)

const

Gets the type of the WTLS name.

Return Value: Type of WTLS name form.

NewL ( const TDesC8 & )

IMPORT_C CWTLSName *

NewL

(

const TDesC8 &

aBinaryData

)

[static]

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

Parameters
aBinaryData	The encoded binary representation.

Return Value: The new CWTLSName object.

NewL ( const TDesC8 &, TInt & )

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

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

Parameters
aBinaryData	The encoded binary representation.
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: The new CWTLSName object.

NewL ( const CWTLSName & )

IMPORT_C CWTLSName *

NewL

(

const CWTLSName &

aName

)

[static]

Creates a new CWTLSName object from an existing one.

Parameters
aName	An existing CWTLSName object.

Return Value: The new CWTLSName object.

NewLC ( const TDesC8 & )

IMPORT_C CWTLSName *

NewLC

(

const TDesC8 &

aBinaryData

)

[static]

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
aBinaryData	The encoded binary representation.

Return Value: The new CWTLSName object.

NewLC ( const TDesC8 &, TInt & )

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

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
aBinaryData	The encoded binary representation.
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: The new CWTLSName object.

NewLC ( const CWTLSName & )

IMPORT_C CWTLSName *

NewLC

(

const CWTLSName &

aName

)

[static]

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

Parameters
aName	An existing CWTLSName object.

Return Value: The new CWTLSName object.