Collapse all Symbian^3 Application Developer Library

UserPromptService::CDecisionRecord Class Reference

class UserPromptService::CDecisionRecord : public CBase

Stores all the field values in a decision database row. All member variables of the class are constant and public. Therefore, the members are assigned during construction and then they can be accessible directly, however, it is not possible to modify them.

Inherits from

UserPromptService::CDecisionRecord
- CBase

Public Member Functions
	~CDecisionRecord ()
IMPORT_C void	ExternalizeL ( RWriteStream &)
IMPORT_C void	InternalizeL ( RReadStream &)
IMPORT_C CDecisionRecord *	NewL (const TSecureId &, const TUid &, const TUid &, const TSecureId &, const TDesC8 &, const TDesC8 &, const TDesC &, const TUint8 , const TUint16 &, const TUint32 , const TUint32 &)
IMPORT_C CDecisionRecord *	NewLC (const TSecureId &, const TUid &, const TUid &, const TSecureId &, const TDesC8 &, const TDesC8 &, const TDesC &, const TUint8 , const TUint16 &, const TUint32 , const TUint32 &)
IMPORT_C CDecisionRecord *	NewLC ()

Private Member Functions
	CDecisionRecord ()
	CDecisionRecord (const TSecureId &, const TUid &, const TUid &, const TSecureId &, const TUint8 , const TUint16 &, const TUint32 , const TUint32 &)
void	ConstructL (const TDesC8 &, const TDesC8 &, const TDesC &)
void	ValidateL ()

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
RBuf8	iClientEntity
TSecureId	iClientSid
RBuf	iDescription
TUid	iEvaluatorId
TUint32	iEvaluatorInfo
RBuf8	iFingerprint
TUint16	iMajorPolicyVersion
TUint32	iRecordId
TUint8	iResult
TSecureId	iServerSid
TUid	iServiceId

Constructor & Destructor Documentation

CDecisionRecord()

CDecisionRecord

(

)

[private]

Constructor for the decision record.

CDecisionRecord(const TSecureId &, const TUid &, const TUid &, const TSecureId &, const TUint8, const TUint16 &, const TUint32, const TUint32 &)

CDecisionRecord	(	const TSecureId &	aClientSid,
		const TUid &	aEvaluatorId,
		const TUid &	aServiceId,
		const TSecureId &	aServerSid,
		const TUint8	aResult,
		const TUint16 &	aMajorPolicyVersion,
		const TUint32	aEvaluatorInfo,
		const TUint32 &	aRecordId
	)	[private]

Constructor for the decision record. Assigns the ID values.

Parameters

const TSecureId & aClientSid
const TUid & aEvaluatorId
const TUid & aServiceId
const TSecureId & aServerSid
const TUint8 aResult
const TUint16 & aMajorPolicyVersion
const TUint32 aEvaluatorInfo
const TUint32 & aRecordId

~CDecisionRecord()

~CDecisionRecord

(

)

Destructor for the decision record object

Member Functions Documentation

ConstructL(const TDesC8 &, const TDesC8 &, const TDesC &)

void	ConstructL	(	const TDesC8 &	aFingerprint,
			const TDesC8 &	aClientEntity,
			const TDesC &	aDescription
		)	[private]

Second phase constructor for the decision record. Sets members allocated on the heap. The function leaves, if any buffer allocation fails. CDecisionRecord::NewL()

Parameters

const TDesC8 & aFingerprint
const TDesC8 & aClientEntity
const TDesC & aDescription

ExternalizeL(RWriteStream &)

IMPORT_C void

ExternalizeL

(

RWriteStream &

aStream

)

const

Externalise this CDecisionRecord object to the specified stream.

Parameters

RWriteStream & aStream

InternalizeL(RReadStream &)

IMPORT_C void

InternalizeL

(

RReadStream &

aStream

)

Internalise this CDecisionRecord object from the specified stream.

Parameters

RReadStream & aStream

NewL(const TSecureId &, const TUid &, const TUid &, const TSecureId &, const TDesC8 &, const TDesC8 &, const TDesC &, const TUint8, const TUint16 &, const TUint32, const TUint32 &)

IMPORT_C CDecisionRecord *	NewL	(	const TSecureId &	aClientSid,
			const TUid &	aEvaluatorId,
			const TUid &	aServiceId,
			const TSecureId &	aServerSid,
			const TDesC8 &	aFingerprint,
			const TDesC8 &	aClientEntity,
			const TDesC &	aDescription,
			const TUint8	aResult,
			const TUint16 &	aMajorPolicyVersion,
			const TUint32	aEvaluatorInfo,
			const TUint32 &	aRecordId = 0
		)	[static]

Creates a decision record object. The function leaves, if creation of the record object fails.

Parameters

const TSecureId & aClientSid	Secure Id of client application
const TUid & aEvaluatorId	UID for the policy evaluator DLL
const TUid & aServiceId	UID for service e.g. sms, mms, telephony, gprs
const TSecureId & aServerSid	Secure Id for the system server that the decision applies to
const TDesC8 & aFingerprint	Hash of the destination and/or opaque data. Maximum length is 32 bytes.
const TDesC8 & aClientEntity	The name of the entity within the client that requested the service. Maximum length is 32 bytes.
const TDesC & aDescription	A copy of description and/or opaque.
const TUint8 aResult	Whether the request should be approved (=1) or denied (=0)
const TUint16 & aMajorPolicyVersion	The major version of the policy file.
const TUint32 aEvaluatorInfo	Policy evaluator specific data
const TUint32 & aRecordId = 0	An auto-incrementing record number.

NewLC(const TSecureId &, const TUid &, const TUid &, const TSecureId &, const TDesC8 &, const TDesC8 &, const TDesC &, const TUint8, const TUint16 &, const TUint32, const TUint32 &)

IMPORT_C CDecisionRecord *	NewLC	(	const TSecureId &	aClientSid,
			const TUid &	aEvaluatorId,
			const TUid &	aServiceId,
			const TSecureId &	aServerSid,
			const TDesC8 &	aFingerprint,
			const TDesC8 &	aClientEntity,
			const TDesC &	aDescription,
			const TUint8	aResult,
			const TUint16 &	aMajorPolicyVersion,
			const TUint32	aEvaluatorInfo,
			const TUint32 &	aRecordId = 0
		)	[static]

Creates a decision record object. The function leaves, if creation of the record object fails.

CDecisionRecord::NewL()

Parameters

const TSecureId & aClientSid
const TUid & aEvaluatorId
const TUid & aServiceId
const TSecureId & aServerSid
const TDesC8 & aFingerprint
const TDesC8 & aClientEntity
const TDesC & aDescription
const TUint8 aResult
const TUint16 & aMajorPolicyVersion
const TUint32 aEvaluatorInfo
const TUint32 & aRecordId = 0

NewLC()

IMPORT_C CDecisionRecord *

NewLC

(

)

[static]

Creates a decision record object. The function leaves, if creation of the record object fails.

ValidateL()

void

ValidateL

(

)

[private]

Check both the fingerprint and client entity are not too long. An absent fingerprint or client entity is represent by an empty string.

Member Data Documentation

RBuf8 iClientEntity

RBuf8

iClientEntity

Name of the entity within client

TSecureId iClientSid

TSecureId

iClientSid

Secure Id of client application

RBuf iDescription

RBuf	iDescription

A copy of description and/or opaque

TUid iEvaluatorId

TUid	iEvaluatorId

UID for the policy evaluator DLL

TUint32 iEvaluatorInfo

TUint32

iEvaluatorInfo

Policy evaluator specific data

RBuf8 iFingerprint

RBuf8

iFingerprint

Fingerprint

TUint16 iMajorPolicyVersion

TUint16

iMajorPolicyVersion

Major policy version which this decision record possesses to.

TUint32 iRecordId

TUint32

iRecordId

Unique decision record Id.

TUint8 iResult

TUint8

iResult

Whether the request should be approved

TSecureId iServerSid

TSecureId

iServerSid

Secure Id for system server

TUid iServiceId

TUid	iServiceId

UID for service