Symbian
Developer Library

DEVELOPER LIBRARY

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

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

Location: certstore.h
Link against: certstore.lib

Class CCertStoreEntry

CCertStoreEntry

Support

Supported from 6.0

Description

A certificate store entry.

Provides information about which applications trust the certificate.

Derivation

CBaseBase class for all classes to be instantiated on the heap
CCertStoreEntryA certificate store entry

Defined in CCertStoreEntry:
AddTrusterL(), ExternalizeL(), Fingerprint(), Mapping(), Mapping(), NewL(), NewL(), NewL(), NewLC(), NewLC(), NewLC(), RemoveTrusterL(), SetMapping(), Trusted(), Trusters(), ~CCertStoreEntry()

Inherited from CBase:
operator new()

Construction and destruction

NewL()

static CCertStoreEntry* NewL(const CArrayFix<TUid>& aTrusters, CCertStore& aStore, const TDesC8& aFingerprint);

Description

Creates a new certificate store entry with the specified fingerprint, certificate store and a set of Uids that identify the trusting applications.

Parameters

const CArrayFix<TUid>& aTrusters

The trusters.
const CCertStore& aStore

The certificate store.
const TDesC8& aFingerprint

The fingerprint.

Return value

CCertStoreEntry*

A new certificate store entry.

NewL()

static CCertStoreEntry* NewL(const CCertStoreEntry& aEntry);

Description

Copy constructor.

Parameters

const CCertStoreEntry& aEntry

The certificate store entry to be copied.

Return value

CCertStoreEntry*

A new certificate store entry.

NewL()

static CCertStoreEntry* NewL(RReadStream& aStream, CCertStore& aStore);

Description

Creates a new certificate store entry from a stream and a certificate store.

Construction is from a stream and a certificate store.

Parameters

RReadStream& aStream

The read stream.
CCertStore& aStore

The certificate store.

Return value

CCertStoreEntry*

A new certificate store entry.

NewLC()

static CCertStoreEntry* NewLC(const CArrayFix<TUid>& aTrusters, CCertStore& aStore, const TDesC8& aFingerprint);

Description

Creates a new certificate store entry with the specified fingerprint, certificate store and a set of Uids that identify the trusting applications, and puts a pointer to the new object onto the cleanp stack.

Parameters

const CArrayFix<TUid>& aTrusters

The trusters.
const CCertStore& aStore

The certificate store.
const TDesC8& aFingerprint

The fingerprint.

Return value

CCertStoreEntry*

A new certificate store entry.

NewLC()

static CCertStoreEntry* NewLC(const CCertStoreEntry& aEntry);

Description

Copy constructor, putting a pointer to the new object onto the cleanup stack.

Parameters

const CCertStoreEntry& aEntry

The certificate store entry to be copied.

Return value

CCertStoreEntry*

A new certificate store entry.

NewLC()

static CCertStoreEntry* NewLC(RReadStream& aStream, CCertStore& aStore);

Description

Creates a new certificate store entry from a stream and a certificate store, , putting a pointer to the new object onto the cleanup stack.

Construction from a stream and a certificate store.

Parameters

RReadStream& aStream

The read stream.
CCertStore& aStore

The certificate store.

Return value

CCertStoreEntry*

A new certificate store entry.

~CCertStoreEntry()

~CCertStoreEntry();

Description

Destructor.

[Top]

Member functions

Trusters()

const CArrayFixFlat<TUid>& Trusters() const;

Description

Gets the set of trusters for the certificate.

Return value

CArrayFixFlat<TUid>&

The set of trusters.

Trusted()

TBool Trusted(const CArrayFix<TUid>& aTrusters) const;

Description

Tests if the certificate is trusted by any of the specified applications.

Parameters

const CArrayFix<TUid>& aTrusters

The specified trusters.

Return value

TBool

ETrue if the certificate is trusted by any of the trusters specified by the parameter, EFalse if not.

AddTrusterL()

void AddTrusterL(TUid aTruster);

Description

Adds a trusted application.

Parameters

TUid aTruster

The new truster's UID.

RemoveTrusterL()

void RemoveTrusterL(TUid aTruster);

Description

Removes the specified truster.

Returns KErrNone, or KErrNotFound if the certificate is not already trusted by that application.

Parameters

TUid aTruster

The truster's Uid.

Leave codes

KErrNone

If the certificate is not already trusted by that application.
KErrNotFound

If the certificate is not already trusted by that application.

Fingerprint()

TPtrC8 Fingerprint() const;

Description

Gets the fingerprint.

Return value

TPtrC8

A constant pointer descriptor representing the fingerprint.

Mapping()

CCertStoreMapping& Mapping();

Description

Gets the certficate store mapping.

Return value

CCertStoreMapping&

The certficate store mapping.

Mapping()

const CCertStoreMapping& Mapping() const;

Description

Gets the certficate store mapping (const version).

Return value

CCertStoreMapping&

The certficate store mapping.

SetMapping()

void SetMapping(CCertStoreMapping* aMapping);

Description

Sets the certficate store mapping.

Any existing certificate store mapping object is deleted.

Parameters

CCertStoreMapping* aMapping

The certficate store mapping.

ExternalizeL()

void ExternalizeL(RWriteStream& aStream) const;

Description

Externalizes the certificate store entry to a stream.

Parameters

RWriteStream& aStream

The write stream.

©2002 Symbian Ltd.

[Top]