CWTLSName Class Reference

#include <wtlsnames.h>

Link against: wtlscert.lib

class CWTLSName : public CBase

Inherits from

CWTLSName

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.

Returns: 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.

Parameter	Description
aName	An existing CWTLSName object.

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

NameData ( )

IMPORT_C TPtrC8

NameData

(

)

const

Gets the encoding of the underlying type of WTLS name.

Returns: Pointer descriptor representing the encoding of the WTLS name type.

NameType ( )

IMPORT_C TWTLSNameType

NameType

(

)

const

Gets the type of the WTLS name.

Returns: 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.

Parameter	Description
aBinaryData	The encoded binary representation.

Returns: 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.

Parameter	Description
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.

Returns: The new CWTLSName object.

NewL ( const CWTLSName & )

IMPORT_C CWTLSName *

NewL

(

const CWTLSName &

aName

)

[static]

Creates a new CWTLSName object from an existing one.

Parameter	Description
aName	An existing CWTLSName object.

Returns: 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.

Parameter	Description
aBinaryData	The encoded binary representation.

Returns: 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.

Parameter	Description
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.

Returns: 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.

Parameter	Description
aName	An existing CWTLSName object.

Returns: The new CWTLSName object.