Symbian
Symbian OS Library

SYMBIAN OS V9.3

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



Location: wtlscertchain.h
Link against: wtlscert.lib

Class CWTLSCertChain

class CWTLSCertChain : public CBase;

Description

Implements a WTLS certificate chain.

Derivation

Members

Defined in CWTLSCertChain:
AppendCertsL(), Cert(), ChainHasRoot(), Count(), NewL(), NewL(), NewLC(), NewLC(), ValidateL(), ~CWTLSCertChain()

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


Construction and destruction


NewL()

static IMPORT_C CWTLSCertChain *NewL(RFs &aFs, const TPtrC8 &aEncodedCerts, const TUid aClient);

Description

Creates a certificate chain using the binary data in aEncodedCerts.

Parameters

RFs &aFs

An open file server session.

const TPtrC8 &aEncodedCerts

One or more concatenated DER encoded WTLS certificates. The first certificate will be interpreted as the end entity certificate to be validated; subsequent certificates may be in any order and may be used by the chain as intermediate certificates, but not root certificates.

const TUid aClient

The uid of the client. It is a value identifying the application to the chain; this will be used to select a subset of stored certificates to use as candidate root certificates.

Return value

CWTLSCertChain *


NewLC()

static IMPORT_C CWTLSCertChain *NewLC(RFs &aFs, const TPtrC8 &aEncodedCerts, const TUid aClient);

Description

Creates a certificate chain using the binary data in aEncodedCerts and puts a pointer to the new object onto the cleanup stack.

Parameters

RFs &aFs

An open file server session

const TPtrC8 &aEncodedCerts

One or more concatenated DER encoded WTLS certificates. The first certificate will be interpreted as the end entity certificate to be validated; subsequent certificates may be in any order and may be used by the chain as intermediate certificates, but not root certificates.

const TUid aClient

The uid of the client. It is a value identifying the application to the chain; this will be used to select a subset of stored certificates to use as candidate root certificates.

Return value

CWTLSCertChain *


NewL()

static IMPORT_C CWTLSCertChain *NewL(RFs &aFs, const TPtrC8 &aEncodedCerts, const CArrayPtr< CWTLSCertificate > &aRootCerts);

Description

Creates a certificate chain using the binary data in aEncodedCerts.

Parameters

RFs &aFs

An open file server session.

const TPtrC8 &aEncodedCerts

One or more concatenated DER encoded WTLS certificates. The first certificate will be interpreted as the end entity certificate to be validated; subsequent certificates may be in any order and may be used by the chain as intermediate certificates, but not root certificates. Any self signed certificates supplied here after the first one will be discarded, as self signed certificates cannot by definition be intermediate certificates.

const CArrayPtr< CWTLSCertificate > &aRootCerts

An array of certificates which the chain will treat as candidate root certificates. If one of these overloads is used, the chain will not look in stores for root certificates, but will only use the certificates supplied here.

Return value

CWTLSCertChain *


NewLC()

static IMPORT_C CWTLSCertChain *NewLC(RFs &aFs, const TPtrC8 &aEncodedCerts, const CArrayPtr< CWTLSCertificate > &aRootCerts);

Description

Creates a certificate chain using the binary data in aEncodedCerts and puts a pointer to the new object onto the cleanup stack.

Parameters

RFs &aFs

An open file server session.

const TPtrC8 &aEncodedCerts

One or more concatenated DER encoded WTLS certificates. The first certificate will be interpreted as the end entity certificate to be validated; subsequent certificates may be in any order and may be used by the chain as intermediate certificates, but not root certificates. Any self signed certificates supplied here after the first one will be discarded as self signed certificates cannot by definition be intermediate certificates.

const CArrayPtr< CWTLSCertificate > &aRootCerts

An array of certificates which the chain will treat as candidate root certificates. If one of these overloads is used, the chain will not look in stores for root certificates, but will only use the certificates supplied here.

Return value

CWTLSCertChain *


~CWTLSCertChain()

IMPORT_C ~CWTLSCertChain();

Description

Destructor.

Frees all resources owned by the object.

[Top]


Member functions


ValidateL()

IMPORT_C void ValidateL(CWTLSValidationResult &aValidationResult, const TTime &aValidationTime, TRequestStatus &aStatus);

Description

Validates the chain.

Parameters

CWTLSValidationResult &aValidationResult

On completion, this contains the result of the validation.

const TTime &aValidationTime

The time for which validation should be performed, usually the current time.

TRequestStatus &aStatus

An asynchronous request status object.


Count()

IMPORT_C TInt Count() const;

Description

Gets the number of WTLS certificates in the chain.

Return value

TInt

The number of WTLS certificates in the chain.


Cert()

IMPORT_C const CWTLSCertificate &Cert(TInt aIndex) const;

Description

Gets the certificate at the specified index.

Parameters

TInt aIndex

The ordinal number representing the position of the certificate within the chain.

Return value

const CWTLSCertificate &

The WTLS certificate at the specified index.


ChainHasRoot()

IMPORT_C TBool ChainHasRoot() const;

Description

Tests whether the root certificate of the chain is locatable.

Note that the value is only significant after a successfull call to ValidateL().

Return value

TBool

ETrue if the chain has a root; EFalse, otherwise.


AppendCertsL()

IMPORT_C void AppendCertsL(const TPtrC8 &aEncodedCerts);

Description

Appends the specified encoded certificate to the chain.

Parameters

const TPtrC8 &aEncodedCerts

One or more concatenated DER encoded WTLS certificates. These certificates will be used as candidates. The first certificate will be interpreted as the end entity certificate to be validated; subsequent certificates may be in any order and may be used by the chain as intermediate certificates, but not root certificates.