Collapse all Symbian^3 Product Developer Library

PKCS12::CDecPkcs12 Class Reference

class PKCS12::CDecPkcs12 : public CBase

Contains methods to decode and return the PFX structure. The structure contains the Version, MacData and AuthSafe. MacData is OPTIONAL.

Inherits from

PKCS12::CDecPkcs12
- CBase

Public Member Functions
	~CDecPkcs12()
IMPORT_C const CPKCS7ContentInfo &	AuthenticatedSafe()
IMPORT_C const RPointerArray< CPKCS7ContentInfo > &	AuthenticatedSafeContents()
IMPORT_C TIntegrityMode	IntegrityMode()
IMPORT_C const CDecPkcs12MacData *	MacData()
IMPORT_C CDecPkcs12 *	NewL(const TDesC8 &)
IMPORT_C CDecPkcs12 *	NewL(RReadStream &)
IMPORT_C CDecPkcs12 *	NewLC(const TDesC8 &)
IMPORT_C CDecPkcs12 *	NewLC(RReadStream &)
IMPORT_C TInt	Version()

Private Member Functions
	CDecPkcs12()
	CDecPkcs12(RPointerArray< CPKCS7ContentInfo >)
	CDecPkcs12(const CDecPkcs12 &)
void	ConstructL(const TDesC8 &)
void	InternalizeL(RReadStream &)
CDecPkcs12 &	operator=(const CDecPkcs12 &)

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 Member Enumerations
enum	TIntegrityMode { EPasswordIntegrityMode = 1, EPublicKeyIntegrityMode }

Private Attributes
CPKCS7ContentInfo *	iAuthenticatedSafeData
RPointerArray< CPKCS7ContentInfo >	iContentInfos
CDecPkcs12MacData *	iMacData
TIntegrityMode	iMode
TInt	iVersion

Constructor & Destructor Documentation

CDecPkcs12()

CDecPkcs12

(

)

[private]

Constructor.

CDecPkcs12(RPointerArray< CPKCS7ContentInfo >)

CDecPkcs12

(

RPointerArray< CPKCS7ContentInfo >

aContentInfo

)

[private]

Construtor.

Parameters

RPointerArray< CPKCS7ContentInfo > aContentInfo

CDecPkcs12(const CDecPkcs12 &)

CDecPkcs12

(

const CDecPkcs12 &

aDecPkcs12

)

[private]

Copy Constructor.

Parameters

const CDecPkcs12 & aDecPkcs12

A CDecPkcs12 object

~CDecPkcs12()

~CDecPkcs12

(

)

[virtual]

Destructor.

Member Functions Documentation

AuthenticatedSafe()

IMPORT_C const CPKCS7ContentInfo &

AuthenticatedSafe

(

)

const

Returns the authenticated safe. This authenticated safe is used to find the integrity mode used and to verify the integrity of the packet.

AuthenticatedSafeContents()

IMPORT_C const RPointerArray< CPKCS7ContentInfo > &

AuthenticatedSafeContents

(

)

const

These objects represents the ContentInfo Sequences present in the AuthenticatedSafe Sequence.

CPKCS7ContentInfo

ConstructL(const TDesC8 &)

void

ConstructL

(

const TDesC8 &

aRawData

)

[private]

This decodes the entire PFX structure

Main PKCS12 Structure. PFX ::= SEQUENCE { version INTEGER {v3(3)}(v3,...), authSafe ContentInfo, macData MacData OPTIONAL }

leave: KErrArgument if the aRawData is not a Valid Pkcs12 PFX Structure.

CPKCS7ContentInfo, CDecPkcs12MacData, CPKCS7SignedObject.

Parameters

const TDesC8 & aRawData

Contains a PKCS#12 PFX Structure.

IntegrityMode()

IMPORT_C TIntegrityMode

IntegrityMode

(

)

const

Identifies the type of integrity mode used. In the case of Password Integrity mode, OID is 1.2.840.113549.1.7.1. In the case of Public Key Integrity mode, OID is 1.2.840.113549.1.7.2.

InternalizeL(RReadStream &)

void

InternalizeL

(

RReadStream &

aStream

)

[private]

This method is used to internalise that object and takes a reference to an RReadStream as the interface to the read stream.

leave: KErrArgument if the aStream is not Pkcs12 PFX Structure.

Parameters

RReadStream & aStream

Contains a PKCS#12 PFX Structure.

MacData()

IMPORT_C const CDecPkcs12MacData *

MacData

(

)

const

The MacData, which contains:

The Mac, that is the PKCS#7 digest info structure.
The MacSalt.
The iteration count.

NewL(const TDesC8 &)

IMPORT_C CDecPkcs12 *

NewL

(

const TDesC8 &

aRawData

)

[static]

Creates a new PKCS#12 object.

leave: KErrArgument if the aRawData is not Pkcs12 PFX Structure.

Parameters

const TDesC8 & aRawData

Contains a PKCS#12 PFX structure

NewL(RReadStream &)

IMPORT_C CDecPkcs12 *

NewL

(

RReadStream &

aStream

)

[static]

Creates a new PKCS#12 object.

leave: KErrArgument if the aRawData is not Pkcs12 PFX Structure.

Parameters

RReadStream & aStream

contains a PKCS#12 PFX structure

NewLC(const TDesC8 &)

IMPORT_C CDecPkcs12 *

NewLC

(

const TDesC8 &

aRawData

)

[static]

Creates a new PKCS#12 object.

leave: KErrArgument if the aRawData is not Pkcs12 PFX Structure.

Parameters

const TDesC8 & aRawData

Contains a PKCS#12 PFX structure

NewLC(RReadStream &)

IMPORT_C CDecPkcs12 *

NewLC

(

RReadStream &

aStream

)

[static]

Creates a new PKCS#12 object.

leave: KErrArgument if the aRawData is not Pkcs12 PFX Structure.

Parameters

RReadStream & aStream

Contains a PKCS#12 PFX structure

Version()

IMPORT_C TInt

Version

(

)

const

Returns the Version number contained in the PKCS12 PFX Structure.

operator=(const CDecPkcs12 &)

CDecPkcs12 &

operator=

(

const CDecPkcs12 &

aDecPkcs12

)

[private]

Assignment operator.

Parameters

const CDecPkcs12 & aDecPkcs12

A CDecPkcs12 object.

Member Enumerations Documentation

Enum TIntegrityMode

Identifies the type of Integrity Mode used in the PKCS12 PFX Structure

Enumerators

EPasswordIntegrityMode = 1	Password Integrity Mode used in the PKCS12 PFX Structure
EPublicKeyIntegrityMode	Public Key Integrity Mode used in the PKCS12 PFX Structure