Symbian^3 Application Developer Library >

CryptoSpi::MAsyncMac Class Reference

class CryptoSpi::MAsyncMac : public CryptoSpi::MPlugin

Asynchronous MAC interface typically used by the plug-in implementations that are based for dedicated crypto hardware.

Inherits from

Public Member Functions
void Cancel ()
MAsyncMac * CopyL ()
TPtrC8 FinalL (const TDesC8 &, TRequestStatus &)
TPtrC8 MacL (const TDesC8 &, TRequestStatus &)
void ReInitialiseAndSetKeyL (const CKey &)
MAsyncMac * ReplicateL ()
void UpdateL (const TDesC8 &, TRequestStatus &)
Inherited Functions
CryptoSpi::MPlugin::Close()
CryptoSpi::MPlugin::GetCharacteristicsL(const TCharacteristics *&)
CryptoSpi::MPlugin::GetExtendedCharacteristicsL()
CryptoSpi::MPlugin::GetExtension(TUid)
CryptoSpi::MPlugin::Reset()

Member Functions Documentation

Cancel()

void Cancel ( ) [pure virtual]

Cancels an outstanding request from the client.

CopyL()

MAsyncMac * CopyL ( ) [pure virtual]

Creates a new MAsyncMac object with the exact same state as the current object. This function copies all internal state of the message digest.

leave
... Any of the crypto error codes defined in cryptospi_errs.h or any of the system-wide error codes.

FinalL(const TDesC8 &, TRequestStatus &)

TPtrC8 FinalL ( const TDesC8 & aMessage,
TRequestStatus & aStatus
) [pure virtual]

Produces a final MAC value from all the previous updates of data to be MACed. It resets the MAC algorithm in a state similar to creating a new MAC instance with the same underlying algorithm and supplied symmetric key.

leave
... Any of the crypto error codes defined in cryptospi_errs.h or any of the system-wide error codes.

Parameters

const TDesC8 & aMessage The data to be included in the MAC evaluation.
TRequestStatus & aStatus Holds the completion status of an asynchronous request for MAC evaluation.

MacL(const TDesC8 &, TRequestStatus &)

TPtrC8 MacL ( const TDesC8 & aMessage,
TRequestStatus & aStatus
) [pure virtual]

Adds message to the internal representation of data for which the MAC value, needs to be evaluated and then returns a TPtrC8 of the finalised MAC value of all the previously appended messages.

leave
... Any of the crypto error codes defined in cryptospi_errs.h or any of the system-wide error codes.

Parameters

const TDesC8 & aMessage The data for which MAC value is to be evaluated.
TRequestStatus & aStatus Holds the completion status of an asynchronous request for MAC evaluation.

ReInitialiseAndSetKeyL(const CKey &)

void ReInitialiseAndSetKeyL ( const CKey & aKey ) [pure virtual]

This re-initialises the underlying MAC algorithm with a new symmetric key. It resets the MAC algorithm in a state similar to creating a new MAC instance with the same underlying algorithm but a new symmetric key.

leave
... Any of the crypto error codes defined in cryptospi_errs.h or any of the system-wide error codes.

Parameters

const CKey & aKey Symmetric key for calculating message authentication code value.

ReplicateL()

MAsyncMac * ReplicateL ( ) [pure virtual]

Creates a brand new reset MAsyncMac object containing no state information from the current object.

leave
... Any of the crypto error codes defined in cryptospi_errs.h or any of the system-wide error codes.

UpdateL(const TDesC8 &, TRequestStatus &)

void UpdateL ( const TDesC8 & aMessage,
TRequestStatus & aStatus
) [pure virtual]

Adds data to the internal representation of messages for which the MAC value needs to be evaluated.

leave
... Any of the crypto error codes defined in cryptospi_errs.h or any of the system-wide error codes.

Parameters

const TDesC8 & aMessage The data to be included in the MAC evaluation.
TRequestStatus & aStatus Holds the completion status of an asynchronous request for MAC evaluation.

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.