Symbian^3 Application Developer Library >

CCTCertInfo Class Reference

class CCTCertInfo : protected CBase

Encapsulates information about a stored certificate.

Objects of this type are usually returned by a certificate store, to allow a client to query the contents of the store.

Note that these objects are normally constructed by certificate stores, not by clients.

Inherits from

Public Member Functions
IMPORT_C TCertificateFormat CertificateFormat ()
IMPORT_C TCertificateOwnerType CertificateOwnerType ()
IMPORT_C TCTTokenObjectHandle Handle ()
IMPORT_C TBool IsDeletable ()
IMPORT_C const TDesC8 * IssuerHash ()
IMPORT_C const TKeyIdentifier & IssuerKeyId ()
const TDesC & Label ()
IMPORT_C CCTCertInfo * NewL (const CCTCertInfo &)
IMPORT_C CCTCertInfo * NewL (const TDesC &, TCertificateFormat , TCertificateOwnerType , TInt , const TKeyIdentifier *, const TKeyIdentifier *, MCTToken &, TInt , TBool , const TDesC8 *)
IMPORT_C CCTCertInfo * NewL (const TDesC &, TCertificateFormat , TCertificateOwnerType , TInt , const TKeyIdentifier *, const TKeyIdentifier *, MCTToken &, TInt )
IMPORT_C CCTCertInfo * NewL ( RReadStream &, MCTToken &)
IMPORT_C CCTCertInfo * NewLC (const CCTCertInfo &)
IMPORT_C CCTCertInfo * NewLC (const TDesC &, TCertificateFormat , TCertificateOwnerType , TInt , const TKeyIdentifier *, const TKeyIdentifier *, MCTToken &, TInt , TBool , const TDesC8 *)
IMPORT_C CCTCertInfo * NewLC (const TDesC &, TCertificateFormat , TCertificateOwnerType , TInt , const TKeyIdentifier *, const TKeyIdentifier *, MCTToken &, TInt )
IMPORT_C CCTCertInfo * NewLC ( RReadStream &, MCTToken &)
IMPORT_C void SetCertificateId ( TInt )
IMPORT_C TInt Size ()
IMPORT_C const TKeyIdentifier & SubjectKeyId ()
MCTToken & Token ()
TUid Type ()
IMPORT_C TBool operator== (const CCTCertInfo &)
Protected Member Functions
~CCTCertInfo ()
Private Member Functions
CCTCertInfo ( MCTToken &)
CCTCertInfo (const TDesC &, TCertificateFormat , TCertificateOwnerType , TInt , const TKeyIdentifier *, const TKeyIdentifier *, MCTToken &, TInt , TBool )
CCTCertInfo (const CCTCertInfo &)
void ConstructL ( RReadStream &)
void ConstructL (const TDesC8 *)
const CCTCertInfo & operator= (const CCTCertInfo &)
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()
Private Attributes
MCTToken & iToken

Constructor & Destructor Documentation

CCTCertInfo(MCTToken &)

CCTCertInfo ( MCTToken & aToken ) [private]

Parameters

MCTToken & aToken

CCTCertInfo(const TDesC &, TCertificateFormat, TCertificateOwnerType, TInt, const TKeyIdentifier *, const TKeyIdentifier *, MCTToken &, TInt, TBool)

CCTCertInfo ( const TDesC & aLabel,
TCertificateFormat aFormat,
TCertificateOwnerType aCertificateOwnerType,
TInt aSize,
const TKeyIdentifier * aSubjectKeyId,
const TKeyIdentifier * aIssuerKeyId,
MCTToken & aToken,
TInt aCertificateId,
TBool aDeletable
) [private]

Parameters

const TDesC & aLabel
TCertificateFormat aFormat
TCertificateOwnerType aCertificateOwnerType
TInt aSize
const TKeyIdentifier * aSubjectKeyId
const TKeyIdentifier * aIssuerKeyId
MCTToken & aToken
TInt aCertificateId
TBool aDeletable

CCTCertInfo(const CCTCertInfo &)

CCTCertInfo ( const CCTCertInfo & aCertInfo ) [private]

Parameters

const CCTCertInfo & aCertInfo

~CCTCertInfo()

IMPORT_C ~CCTCertInfo ( ) [protected, virtual]

Member Functions Documentation

CertificateFormat()

IMPORT_C TCertificateFormat CertificateFormat ( ) const

Gets the certificate format.

CertificateOwnerType()

IMPORT_C TCertificateOwnerType CertificateOwnerType ( ) const

Gets the owner type.

ConstructL(RReadStream &)

void ConstructL ( RReadStream & aStream ) [private]

Parameters

RReadStream & aStream

ConstructL(const TDesC8 *)

void ConstructL ( const TDesC8 * aIssuerHash ) [private]

Parameters

const TDesC8 * aIssuerHash

Handle()

IMPORT_C TCTTokenObjectHandle Handle ( ) const

Gets a handle for the object.

The primary purpose of the handle is to allow token objects to be 'passed' between processes.

TCTTokenObjectHandle

IsDeletable()

IMPORT_C TBool IsDeletable ( ) const

Whether the certificate is deletable.

IssuerHash()

IMPORT_C const TDesC8 * IssuerHash ( ) const

Gets the hash of the issuer's DN.

IssuerKeyId()

IMPORT_C const TKeyIdentifier & IssuerKeyId ( ) const

Gets the issuer key ID.

Label()

const TDesC & Label ( ) const [virtual]

Gets the object's human-readable label.

MCTTokenObject::Label()

NewL(const CCTCertInfo &)

IMPORT_C CCTCertInfo * NewL ( const CCTCertInfo & aCertInfo ) [static]

Construction -- Note that these objects are normally constructed by certificate stores, not by clients.

Creates the certificate information object by copying from an existing object.

leave
KErrNoMemory There is no memory to construct it.

Parameters

const CCTCertInfo & aCertInfo The source certificate information.

NewL(const TDesC &, TCertificateFormat, TCertificateOwnerType, TInt, const TKeyIdentifier *, const TKeyIdentifier *, MCTToken &, TInt, TBool, const TDesC8 *)

IMPORT_C CCTCertInfo * NewL ( const TDesC & aLabel,
TCertificateFormat aFormat,
TCertificateOwnerType aCertificateOwnerType,
TInt aSize,
const TKeyIdentifier * aSubjectKeyId,
const TKeyIdentifier * aIssuerKeyId,
MCTToken & aToken,
TInt aCertificateId,
TBool aDeletable,
const TDesC8 * aIssuerHash = NULL
) [static]

Creates the certificate information object from its constituent parts.

leave
KErrNoMemory There is no memory to construct it.

Parameters

const TDesC & aLabel The certificate's label.
TCertificateFormat aFormat The certificate's format.
TCertificateOwnerType aCertificateOwnerType The owner type.
TInt aSize The size of the certificate.
const TKeyIdentifier * aSubjectKeyId The subject key ID.
const TKeyIdentifier * aIssuerKeyId The issuer key ID.
MCTToken & aToken The token that the certificate is within.
TInt aCertificateId The ID within the object handle.
TBool aDeletable The certificate is deletable.
const TDesC8 * aIssuerHash = NULL The hash of the DN of the issuer.

NewL(const TDesC &, TCertificateFormat, TCertificateOwnerType, TInt, const TKeyIdentifier *, const TKeyIdentifier *, MCTToken &, TInt)

IMPORT_C CCTCertInfo * NewL ( const TDesC & aLabel,
TCertificateFormat aFormat,
TCertificateOwnerType aCertificateOwnerType,
TInt aSize,
const TKeyIdentifier * aSubjectKeyId,
const TKeyIdentifier * aIssuerKeyId,
MCTToken & aToken,
TInt aCertificateId
) [static]

Creates the certificate information object from its constituent parts.

leave
KErrNoMemory There is no memory to construct it.

Parameters

const TDesC & aLabel The certificate's label.
TCertificateFormat aFormat The certificate's format.
TCertificateOwnerType aCertificateOwnerType The owner type.
TInt aSize The size of the certificate.
const TKeyIdentifier * aSubjectKeyId The subject key ID.
const TKeyIdentifier * aIssuerKeyId The issuer key ID.
MCTToken & aToken The token that the certificate is within.
TInt aCertificateId The ID within the object handle.

NewL(RReadStream &, MCTToken &)

IMPORT_C CCTCertInfo * NewL ( RReadStream & aStream,
MCTToken & aToken
) [static]

Creates the certificate information object by internalising a previously externalised one.

leave
KErrNoMemory There is no memory to construct it.
ExternalizeL InternalizeL

Parameters

RReadStream & aStream The stream from which the object is to be internalised.
MCTToken & aToken The token that it is within.

NewLC(const CCTCertInfo &)

IMPORT_C CCTCertInfo * NewLC ( const CCTCertInfo & aCertInfo ) [static]

Creates the certificate information object by copying from an existing object, and puts a pointer to the new object onto the cleanup stack.

leave
KErrNoMemory There is no memory to construct it.

Parameters

const CCTCertInfo & aCertInfo The source certificate information.

NewLC(const TDesC &, TCertificateFormat, TCertificateOwnerType, TInt, const TKeyIdentifier *, const TKeyIdentifier *, MCTToken &, TInt, TBool, const TDesC8 *)

IMPORT_C CCTCertInfo * NewLC ( const TDesC & aLabel,
TCertificateFormat aFormat,
TCertificateOwnerType aCertificateOwnerType,
TInt aSize,
const TKeyIdentifier * aSubjectKeyId,
const TKeyIdentifier * aIssuerKeyId,
MCTToken & aToken,
TInt aCertificateId,
TBool aDeletable,
const TDesC8 * aIssuerHash = NULL
) [static]

Creates the certificate information object from its constituent parts, and puts a pointer to the new object onto the cleanup stack.

leave
KErrNoMemory There is no memory to construct it.

Parameters

const TDesC & aLabel The certificate's label.
TCertificateFormat aFormat The certificate's format.
TCertificateOwnerType aCertificateOwnerType The owner type.
TInt aSize The size of the certificate.
const TKeyIdentifier * aSubjectKeyId The subject key ID.
const TKeyIdentifier * aIssuerKeyId The issuer key ID.
MCTToken & aToken The token that the certificate is within.
TInt aCertificateId The ID within the object handle.
TBool aDeletable The certificate is deletable.
const TDesC8 * aIssuerHash = NULL The hash of the issuer's DN.

NewLC(const TDesC &, TCertificateFormat, TCertificateOwnerType, TInt, const TKeyIdentifier *, const TKeyIdentifier *, MCTToken &, TInt)

IMPORT_C CCTCertInfo * NewLC ( const TDesC & aLabel,
TCertificateFormat aFormat,
TCertificateOwnerType aCertificateOwnerType,
TInt aSize,
const TKeyIdentifier * aSubjectKeyId,
const TKeyIdentifier * aIssuerKeyId,
MCTToken & aToken,
TInt aCertificateId
) [static]

Creates the certificate information object from its constituent parts, and puts a pointer to the new object onto the cleanup stack.

leave
KErrNoMemory There is no memory to construct it.

Parameters

const TDesC & aLabel The certificate's label.
TCertificateFormat aFormat The certificate's format.
TCertificateOwnerType aCertificateOwnerType The owner type.
TInt aSize The size of the certificate.
const TKeyIdentifier * aSubjectKeyId The subject key ID.
const TKeyIdentifier * aIssuerKeyId The issuer key ID.
MCTToken & aToken The token that the certificate is within.
TInt aCertificateId The ID within the object handle.

NewLC(RReadStream &, MCTToken &)

IMPORT_C CCTCertInfo * NewLC ( RReadStream & aStream,
MCTToken & aToken
) [static]

Creates the certificate information object, by internalising a previously externalised one, and puts a pointer to the new object onto the cleanup stack.

leave
KErrNoMemory There is no memory to construct it.
ExternalizeL InternalizeL

Parameters

RReadStream & aStream The stream from which the object is to be internalised.
MCTToken & aToken The token that it is within.

SetCertificateId(TInt)

IMPORT_C void SetCertificateId ( TInt aCertId )

Sets the certificate Id.

Parameters

TInt aCertId The certificate Id.

Size()

IMPORT_C TInt Size ( ) const

Gets the size of the certificate.

Note that this function must be called so that the correct size of descriptor can be allocated when retrieving the certificate (with MCertStore::Retrieve()).

SubjectKeyId()

IMPORT_C const TKeyIdentifier & SubjectKeyId ( ) const

Gets the subject key ID.

Token()

MCTToken & Token ( ) const [virtual]

Gets a reference to the associated token.

MCTTokenObject::Token()

Type()

TUid Type ( ) const [virtual]

Gets a UID representing the type of the token object.

The function overrides MCTTokenObject::Type() .

The meanings of possible UIDs should be documented in the documentation for the interface that returns them.

MCTTokenObject::Type()

operator=(const CCTCertInfo &)

const CCTCertInfo & operator= ( const CCTCertInfo & aOther ) [private]

Parameters

const CCTCertInfo & aOther

operator==(const CCTCertInfo &)

IMPORT_C TBool operator== ( const CCTCertInfo & aCertInfo ) const

Compares this certificate information object with a specified Certificate Information object for equality.

Parameters

const CCTCertInfo & aCertInfo The certificate information object to be compared.

Member Data Documentation

MCTToken & iToken

MCTToken & iToken [private]

Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License v1.0.