Symbian
Developer Library

DEVELOPER LIBRARY

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

 » Developer Library » API Reference » C++ API reference » Certificate Manager » CSignedObject

Location: signed,h
Link against: crypto.lib

Class CSignedObject

CSignedObject

Support

Supported from 6.0

Description

Base class for certificates.

Derivation

CBaseBase class for all classes to be instantiated on the heap
CSignedObjectBase class for certificates

Defined in CSignedObject:
DataElementEncoding(), Encoding(), ExternalizeL(), Fingerprint(), InternalizeL(), SetParametersL(), Signature(), SignedDataL(), SigningAlgorithm(), VerifySignatureL(), ~CSignedObject()

Inherited from CBase:
operator new()

Destruction

~CSignedObject()

~CSignedObject();

Description

Destructor.

Frees all resources owned by the object.

[Top]

Member functions

VerifySignatureL()

TBool VerifySignatureL(const TDesC8& aEncodedKey) const;

Description

Verifies a signature using the specified encoded key.

Parameters

const TDesC8& aEncodedKey

The encoded key.

Return value

TBool

True if the signature is valid false, otherwise.

Signature()

const TPtrC8 Signature() const;

Description

Gets the digital signature.

Return value

TPtrC8

A non-modifiable pointer descriptor representing the digital signatures.

SignedDataL()

virtual const TPtrC8 SignedDataL() const = 0;

Description

Gets the signed data.

Return value

TPtrC8

A non-modifiable pointer descriptor representing the signed data.

Fingerprint()

const TPtrC8 Fingerprint() const;

Description

Gets the fingerprint.

The fingerprint returned is the MD5 hash of the encoding of the entire object.

Return value

TPtrC8

A non-modifiable pointer descriptor representing the finger print.

Encoding()

const TPtrC8 Encoding() const;

Description

Gets the entire encoding.

Return value

TPtrC8

A non-modifiable pointer descriptor representing the entire encoding.

SigningAlgorithm()

const CSigningAlgorithmIdentifier& SigningAlgorithm() const;

Description

Gets the signing algorithm ID used.

Return value

CSigningAlgorithmIdentifier&

The signing algorithm ID.

ExternalizeL()

virtual void ExternalizeL(RWriteStream& aStream) const;

Description

Externalises the encoding of the entire object to a write stream.

The fingerprint and the signed data can be regenerated after restoration.

Parameters

RWriteStream& aStream

The write stream.

InternalizeL()

virtual void InternalizeL(RReadStream& aStream) = 0;

Description

Internalises the encoded object from a read stream.

The class makes use of a specification-specific parser class for extracting the various elements, and is provided by a subclass of CSignedObject. For this reason this function is pure virtual.

Parameters

RReadStream& aStream

Stream from which the the contents of the field should be internalised.

SetParametersL()

void SetParametersL(const CSigningKeyParameters& aParameters);

Description

Sets the signing key parameters.

Parameters

const CSigningKeyParameters& aParameters

The signing key parameters.

DataElementEncoding()

virtual const TPtrC8* DataElementEncoding(const TUint aIndex) const = 0;

Support

Supported from 6.1

Description

Encodes the data elements.

Parameters

const TUint aIndex

The index.

Return value

TPtrC8*

The encoded data elements.

©2002 Symbian Ltd.

[Top]