Class CWTLSCertificate

class CWTLSCertificate : public CCertificate;

Description

Derivation

• CBase - Base class for all classes to be instantiated on the heap.

• CSignedObject - Base class for certificates.

• CCertificate - A data structure that binds a public key to a given individual.

• CWTLSCertificate - (No abstract)

Members

Defined in CWTLSCertificate:

• DataElementEncoding(const TUint)constGets the encoding for a data element at the specified index.
• EAlgorithmId
• EIssuerName
• ESubjectName
• ESubjectPublicKeyInfo
• EValidityPeriod
• EVersionNumber
• InternalizeL(RReadStream &)Initialises the certificate from a stream.
• IsEqualL(const CWTLSCertificate &)constTests whether this WTLS certificate is the same as the specified WTLS certificat...
• IsSelfSignedL()constTests whether a certificate is self-signed.
• IsTCAL()constTests whether a non-selfsigned certificate can be used to sign others.
• IssuerL()constGets the issuer.
• IssuerName()constGets the name of the WTLS certificate's issuing authority.
• NewL(RReadStream &)Creates a new CWTLSCertificate object from a stream.
• NewL(const CWTLSCertificate &)Creates a new CWTLSCertificate object from an existing one in the certificate st...
• NewL(const TDesC8 &)Creates a new CWTLSCertificate object from the specified buffer containing the b...
• NewL(const TDesC8 &,TInt &)Creates a new CWTLSCertificate object from the specified buffer containing the b...
• NewLC(RReadStream &)Creates a new CWTLSCertificate object from a stream, and puts a pointer to it on...
• NewLC(const CWTLSCertificate &)Creates a new CWTLSCertificate object from an existing one in the certificate st...
• NewLC(const TDesC8 &)Creates a new CWTLSCertificate object from the specified buffer containing the b...
• NewLC(const TDesC8 &,TInt &)Creates a new CWTLSCertificate object from the specified buffer containing the b...
• SignedDataL()constGets the certificate's signed data.
• SubjectL()constGets the subject.
• SubjectName()constGets the name of the owner of the public key the WTLS certificate contains.
• Version()constGets the version number of the WTLS certificate.
• anonymous
• ~CWTLSCertificate()Destructor.

Inherited from CBase:

• Delete(CBase *)Deletes the specified object.
• Extension_(TUint,TAny *&,TAny *)Extension function
• operator new(TUint)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TAny *)Initialises the object to binary zeroes.
• operator new(TUint,TLeave)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TLeave,TUint)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TUint)Allocates the object from the heap and then initialises its contents to binary z...

Inherited from CCertificate:

• KeyIdentifierL()constGets the key identifier.
• PublicKey()constGets the subject public key information.
• SerialNumber()constGets the serial number.
• ValidityPeriod()constGets the validity period.
• iSerialNumberThe serial number.
• iSubjectPublicKeyInfoThe subject public key information.
• iValidityPeriodThe validity period.

Inherited from CSignedObject:

• Encoding()constGets the entire encoding.
• ExternalizeL(RWriteStream &)constExternalises the encoding of the entire object to a write stream.
• Fingerprint()constGets the fingerprint.
• SetParametersL(const CSigningKeyParameters &)Sets the signing key parameters.
• Signature()constGets the digital signature.
• SigningAlgorithm()constGets the signing algorithm ID used.
• VerifySignatureL(const TDesC8 &)constVerifies a signature using the specified encoded key.
• VerifySignatureL(const TDesC8 &,const TDesC8 &)constVerifies a signature using the specified encoded key and hash.
• iEncodingA heap descriptor representing the entire encoding.
• iFingerprintThe fingerprint.
• iKeyFactoryA pointer to a key factory object.
• iParametersThe signing key parameters
• iSignatureThe digital signature.
• iSigningAlgorithmThe signing algorithm ID.

IMPORT_C static CWTLSCertificate* NewL(const TDesC8 &aBinaryData);

Description

Creates a new CWTLSCertificate object from the specified buffer containing the binary coded representation.

Parameters

Return value

IMPORT_C static CWTLSCertificate* NewLC(const TDesC8 &aBinaryData);

Description

Creates a new CWTLSCertificate object from the specified buffer containing the binary coded representation, and puts a pointer to it onto the cleanup stack.

Parameters

Return value

IMPORT_C static CWTLSCertificate* NewL(const TDesC8 &aBinaryData, TInt &aPos);

Description

Creates a new CWTLSCertificate object from the specified buffer containing the binary coded representation.

Parameters

Return value

IMPORT_C static CWTLSCertificate* NewLC(const TDesC8 &aBinaryData, TInt &aPos);

Description

Creates a new CWTLSCertificate object from the specified buffer containing the binary coded representation, and puts a pointer to it onto the cleanup stack.

Parameters

Return value

IMPORT_C static CWTLSCertificate* NewL(RReadStream &aStream);

Description

Creates a new CWTLSCertificate object from a stream.

The stream must have been written using the corresponding CSignedObject::ExternalizeL(RWriteStream &)const function.

Parameters

Return value

IMPORT_C static CWTLSCertificate* NewLC(RReadStream &aStream);

Description

Creates a new CWTLSCertificate object from a stream, and puts a pointer to it onto the cleanup stack.

The stream must have been written using the corresponding CSignedObject::ExternalizeL(RWriteStream &)const function.

Parameters

Return value

IMPORT_C static CWTLSCertificate* NewL(const CWTLSCertificate &aCert);

Description

Creates a new CWTLSCertificate object from an existing one in the certificate store.

Parameters

Return value

IMPORT_C static CWTLSCertificate* NewLC(const CWTLSCertificate &aCert);

Description

Creates a new CWTLSCertificate object from an existing one in the certificate store, and puts a pointer to it onto the cleanup stack.

Parameters

Return value

IMPORT_C ~CWTLSCertificate();

Description

Destructor.

Frees all resources owned by the object, prior to its destruction.

IMPORT_C TBool IsEqualL(const CWTLSCertificate &aCert) const;

Description

Tests whether this WTLS certificate is the same as the specified WTLS certificate.

This is not a simple as it sounds. For X.509 certificates equality means that the issuer name and serial number fields are the same. This guarantees equality since a CA must ensure that every certificate it issues has a unique serial number. But WTLS certificates do not include serial numbers, so there seems to be no definition of equality. This function uses a byte-for-byte comparison of the signatures on the certificates: this should not result in any false positives, but may give false negatives if CAs do naughty things like recertifying the same key (which they have been known to do).

Parameters

Return value

IMPORT_C TInt Version() const;

Description

Gets the version number of the WTLS certificate.

Return value

IMPORT_C const CWTLSName& IssuerName() const;

Description

Gets the name of the WTLS certificate's issuing authority.

Return value

IMPORT_C const CWTLSName& SubjectName() const;

Description

Gets the name of the owner of the public key the WTLS certificate contains.

Return value

IMPORT_C virtual TBool IsSelfSignedL() const;

Description

Tests whether a certificate is self-signed.

Return value

IMPORT_C virtual HBufC* SubjectL() const;

Description

Gets the subject.

Return value

IMPORT_C virtual HBufC* IssuerL() const;

Description

Gets the issuer.

Return value

IMPORT_C virtual void InternalizeL(RReadStream &aStream);

Description

Initialises the certificate from a stream.

This should not be called by client code; instead the static factory function above should be used. If a client is using the certstore component for storage then it should use CCertStore::AddL() for externalizing and CWTLSCert::NewL(CCertStore& aStore, const CCertStoreEntry& aEntry); for restoring.

Parameters

IMPORT_C virtual const TPtrC8 SignedDataL() const;

Description

Gets the certificate's signed data.

Return value

IMPORT_C virtual const TPtrC8* DataElementEncoding(const TUint aIndex) const;

Description

Gets the encoding for a data element at the specified index.

Parameters

Return value

IMPORT_C TBool IsTCAL() const;

Description

Tests whether a non-selfsigned certificate can be used to sign others.

Currently this only supports structured text variety of WTLS certificates. Other certificate types will return EFalse.

Return value

n/a

Description