Class RDecryptStream

RDecryptStream

Support

Supported from 5.0

Description

Supports the decrypting of a stream.

The stream to be decrypted is a stream represented by an existing RReadStream object. In effect, RDecryptStream forms a layer over the RReadStream object, either using its source stream buffer or taking complete ownership of the source stream buffer.

Decryption of streamed data is supported using the TDecryptFilter class derived from TStreamFilter. Decryption itself is performed by a decryption handling object, an instance of a class implementing the CSecurityDecryptBase interface, and which is constructed by a factory function supplied by the security model, an implementation of CSecurityBase.

Derivation

RDecryptStream Supports the decrypting of a stream RReadStream The read stream interface

Defined in RDecryptStream:
AttachL(), AttachLC(), OpenL(), OpenLC(), RDecryptStream()

Inherited from RReadStream:
Attach(), Close(), Detach(), Pop(), PushL(), ReadInt16L(), ReadInt32L(), ReadInt8L(), ReadL(), ReadReal32L(), ReadReal64L(), ReadUint16L(), ReadUint32L(), ReadUint8L(), Release(), Source()

See also:

• TDecryptFilter
• TStreamFilter
• CSecurityDecryptBase
• CSecurityBase

RDecryptStream();

Description

Constructs an empty decrypting stream object.

Call OpenL() or OpenLC() to use a source stream owned by an existing read stream interface object, a RReadStream.

Call AttachL() or AttachLC() to use and take ownership of a source stream owned by an existing read stream interface object.

void AttachL(RReadStream& aHost,const CSecurityBase& aKey,const TDesC8& aInit);

Description

Takes ownership of the source stream owned by the specified read stream interface object, and prepares the stream for reading through a decrypting filter.

The function inserts a decrypting filter, an instance of a TStreamFilter derived class, between itself and the source stream buffer.

Parameters

RReadStream& aHost The read stream interface object for the source stream. CSecurityBase& aKey Interface to the security model used to generate a decryption handling object. const TDesC8& aInit Initialisation vector data for the decryption handling object.

void AttachLC(RReadStream& aHost,const CSecurityBase& aKey,const TDesC8& aInit);

Description

Takes ownership of the source stream owned by the specified read stream interface object, prepares the stream for reading through a decrypting filter, and puts a cleanup item onto the cleanup stack.

The function inserts a decrypting filter, an instance of a TStreamFilter derived class, between itself and the source stream buffer.

Parameters

RReadStream& aHost The read stream interface object for the source stream. CSecurityBase& aKey Interface to the security model used to generate a decryption handling object. const TDesC8& aInit Initialisation vector data for the decryption handling object.

void OpenL(RReadStream& aHost,const CSecurityBase& aKey,const TDesC8& aInit);

Description

Prepares the source stream owned by the specified read stream interface object for reading through a decrypting filter.

The function inserts a decrypting filter, an instance of a TStreamFilter derived class, between itself and the source stream buffer.

The function does not take ownership of the source stream.

Parameters

RReadStream& aHost The read stream interface object for the source stream. const CSecurityBase& aKey Interface to the security model used to generate a decryption handling object. const TDesC8& aInit Initialisation vector data for the decryption handling object.

void OpenLC(RReadStream& aHost,const CSecurityBase& aKey,const TDesC8& aInit);

Description

Prepares the source stream owned by the specified read stream interface object for reading through a decrypting filter, and puts a cleanup item onto the cleanup stack.

The function inserts a decrypting filter, an instance of a TStreamFilter derived class, between itself and the source stream buffer.

The function does not take ownership of the source stream.

Parameters

RReadStream& aHost The read stream interface object for the source stream. const CSecurityBase& aKey Interface to the security model used to generate a decryption handling object. const TDesC8& aInit Initialisation vector data for the decryption handling object.