Collapse all Symbian^3 Application Developer Library

CCertAttributeFilter Class Reference

class CCertAttributeFilter : public CBase

A filter for specifying which certificates are required.

On construction it will accept everything. The Set... functions can then be used to restrict it.

Inherits from

CCertAttributeFilter
- CBase

Public Member Functions
IMPORT_C void	ExternalizeL ( RWriteStream &)
IMPORT_C CCertAttributeFilter *	NewL ()
IMPORT_C CCertAttributeFilter *	NewL ( RReadStream &)
IMPORT_C CCertAttributeFilter *	NewLC ()
IMPORT_C void	SetFormat ( TCertificateFormat )
IMPORT_C void	SetIssuerKeyId (const TKeyIdentifier &)
IMPORT_C void	SetKeyUsage ( TKeyUsageX509 )
IMPORT_C void	SetLabel (const TCertLabel &)
IMPORT_C void	SetOwnerType ( TCertificateOwnerType )
IMPORT_C void	SetSubjectKeyId (const TKeyIdentifier &)
IMPORT_C void	SetUid ( TUid )

Private Member Functions
	CCertAttributeFilter ()
void	InternalizeL ( RReadStream &)

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()

Public Attributes
TCertificateFormat	iFormat
TBool	iFormatIsSet
TKeyIdentifier	iIssuerKeyId
TBool	iIssuerKeyIdIsSet
TKeyUsageX509	iKeyUsage
TCertLabel	iLabel
TBool	iLabelIsSet
TCertificateOwnerType	iOwnerType
TBool	iOwnerTypeIsSet
TKeyIdentifier	iSubjectKeyId
TBool	iSubjectKeyIdIsSet
TUid	iUid
TBool	iUidIsSet

Constructor & Destructor Documentation

CCertAttributeFilter()

CCertAttributeFilter

(

)

[private]

Member Functions Documentation

ExternalizeL(RWriteStream &)

IMPORT_C void

ExternalizeL

(

RWriteStream &

aStream

)

const

Write a certificate attribute filter to a stream.

Externalisation - only output the fields that are set, using the TCertAttribute enum to identify them. Mark the end of the list with ECertAttributeNull.

Parameters

RWriteStream & aStream

InternalizeL(RReadStream &)

void

InternalizeL

(

RReadStream &

aStream

)

[private]

Parameters

RReadStream & aStream

NewL()

IMPORT_C CCertAttributeFilter *

NewL

(

)

[static]

Returns a default filter. This filter accepts any certificate. Call the Set... functions to restrict what it accepts.

NewL(RReadStream &)

IMPORT_C CCertAttributeFilter *

NewL

(

RReadStream &

aStream

)

[static]

Read a certificate attribute filter from a stream.

Parameters

RReadStream & aStream

NewLC()

IMPORT_C CCertAttributeFilter *

NewLC

(

)

[static]

Returns a default filter. This filter accepts any certificate. It leaves the filter on the cleanup stack.

SetFormat(TCertificateFormat)

IMPORT_C void

SetFormat

(

TCertificateFormat

aFormat

)

Sets the format of the returned certificates

Parameters

TCertificateFormat aFormat

The required format

SetIssuerKeyId(const TKeyIdentifier &)

IMPORT_C void

SetIssuerKeyId

(

const TKeyIdentifier &

aIssuerKeyId

)

Sets the issuer key ID that returned certificates must have.

Parameters

const TKeyIdentifier & aIssuerKeyId

The issuer key ID

SetKeyUsage(TKeyUsageX509)

IMPORT_C void

SetKeyUsage

(

TKeyUsageX509

aKeyUsage

)

Sets the usage that returned certs must be used for.

Note that the usage is supplied using X509 scheme - keystore interfaces use the PKCS#15 scheme!

Parameters

TKeyUsageX509 aKeyUsage

The key usage

SetLabel(const TCertLabel &)

IMPORT_C void

SetLabel

(

const TCertLabel &

aLabel

)

Sets the label of the cert that the filter will accept.

Parameters

const TCertLabel & aLabel

The new label

SetOwnerType(TCertificateOwnerType)

IMPORT_C void

SetOwnerType

(

TCertificateOwnerType

aOwnerType

)

Sets the owner type of the returned certificates

Parameters

TCertificateOwnerType aOwnerType

The owner type.

SetSubjectKeyId(const TKeyIdentifier &)

IMPORT_C void

SetSubjectKeyId

(

const TKeyIdentifier &

aSubjectKeyId

)

Sets the subject key ID that returned certificates must have.

Parameters

const TKeyIdentifier & aSubjectKeyId

The subject key ID

SetUid(TUid)

IMPORT_C void

SetUid

(

TUid

aUid

)

Sets the UID of an application which the certificate must support

Parameters

TUid aUid

The new UID

Member Data Documentation

TCertificateFormat iFormat

TCertificateFormat

iFormat

The format of certificates that should be included.

TBool iFormatIsSet

TBool

iFormatIsSet

Indicates that iFormat should be used.

TKeyIdentifier iIssuerKeyId

TKeyIdentifier

iIssuerKeyId

The issuer key that returned certs should have.

TBool iIssuerKeyIdIsSet

TBool

iIssuerKeyIdIsSet

Indicates that iIssuerKeyId should be used.

TKeyUsageX509 iKeyUsage

TKeyUsageX509

iKeyUsage

The usage of keys that should be returned.

TCertLabel iLabel

TCertLabel

iLabel

The filter data. Each data item is accompanied by a '..IsSet' boolean which indicates if the item should be used. Unset values (whose ..IsSet variable is EFalse) should be ignored. The label that returned certificates must have.