Symbian^3 Product Developer Library >

CSendUiFileRightsEngine Class Reference

class CSendUiFileRightsEngine : public CBase

Provides functionality for DRM file protection analyzing and content MMS compatibility resolving.

SenduiDataUtils.lib
Since
Series 60 3.0

Inherits from

  • CSendUiFileRightsEngine
Public Member Functions
~CSendUiFileRightsEngine()
IMPORT_C TIntCalculateTotalSizeOfFiles(CArrayPtrFlat< CSendUiAttachment > *, TBool)
voidCleanupImplArray(TAny *)
IMPORT_C voidClearValidationCounters()
IMPORT_C voidConfirmDrmFileRightsL(CArrayPtrFlat< CSendUiAttachment > *)
IMPORT_C voidConfirmMmsValidityL(CArrayPtrFlat< CSendUiAttachment > *, TUid)
IMPORT_C CSendUiFileRightsEngine *NewL(RFs &)
IMPORT_C CSendUiFileRightsEngine *NewLC(RFs &)
IMPORT_C TBoolShowDrmAndMmsInfoL(TUid)
IMPORT_C voidShowInformationNoteL(TUint)
IMPORT_C voidValidateFiles(CArrayPtrFlat< CSendUiAttachment > *)
Private Member Functions
CSendUiFileRightsEngine(RFs &)
TBool AnalyzeMmsValidationResultL(CSendUiAttachment &, TInt &)
voidConstructL()
voidResolveDrmQuery(TUid, TUint &)
voidResolveErrorNoteL(TUid, TUint &, TFREErrorNoteType &, TUint &)
voidResolveMmsUploadErrorNoteL(TUint &, TFREErrorNoteType &, TUint &)
TBool ShowConfirmationQueryL(TUint, TUint, TUint)
voidShowErrorNoteL(TUint)
voidShowErrorNotificationL(TUint, TFREErrorNoteType, TUint)
TBool ValidateFile(const TDesC &, TInt &)
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()
Private Member Enumerations
enumTFREInvalidTypes {
ESenduiIndexDrmFLOrCCL = 0, ESenduiIndexAlreadyInUse, ESenduiIndexMmsTooBig, ESenduiIndexMmsNotSupported, ESenduiIndexBadHandle, ESenduiIndexLastInvalid
}
enumTFREValidationResults { ESenduiIndexTotalCount = 0, ESenduiIndexDeleted, ESenduiIndexDrmSD, ESenduiIndexLastResult }
Private Attributes
RFs iFileSession
TUint iInvalidationReason
CMsgMediaResolver *iMediaResolver
CMmsConformance *iMmsConformance
CFileProtectionResolver *iProtectionResolver
TUint iValidationResults

Constructor & Destructor Documentation

CSendUiFileRightsEngine(RFs &)

CSendUiFileRightsEngine(RFs &aFS)[private]

C++ default constructor.

Parameters

RFs & aFS

~CSendUiFileRightsEngine()

~CSendUiFileRightsEngine()[virtual]

Destructor.

Member Functions Documentation

AnalyzeMmsValidationResultL(CSendUiAttachment &, TInt &)

TBool AnalyzeMmsValidationResultL(CSendUiAttachment &aAttachment,
TInt &aAttachmentsSize
)[private]
AnalyzeMmsValidationResult
Since
S60 v.3.0

Parameters

CSendUiAttachment & aAttachmentAttachment to be analyzed
TInt & aAttachmentsSize

CalculateTotalSizeOfFiles(CArrayPtrFlat< CSendUiAttachment > *, TBool)

IMPORT_C TIntCalculateTotalSizeOfFiles(CArrayPtrFlat< CSendUiAttachment > *aAttachments,
TBoolaLinksSupported
)

CalculateTotalSizeOfFiles

File sizes saved by ValidateFiles are used. If cached file sizes do not exist, then file sizes are solved.

Attachments If ETrue, then only attachments type of file handles are calculated total size of files. Otherwise filesize of all attachments is returned.

Parameters

CArrayPtrFlat< CSendUiAttachment > * aAttachments
TBool aLinksSupported

CleanupImplArray(TAny *)

voidCleanupImplArray(TAny *aAny)[static]

Cleanup ECOM Implementation info array

Parameters

TAny * aAnyThe array

ClearValidationCounters()

IMPORT_C voidClearValidationCounters()

Clears all validation counter

Since
S60 v3.0

ConfirmDrmFileRightsL(CArrayPtrFlat< CSendUiAttachment > *)

IMPORT_C voidConfirmDrmFileRightsL(CArrayPtrFlat< CSendUiAttachment > *aAttachments)

Confirms DRM rights of files

Note: files must be validated before DRM analyze. This functions also stores mimetypes of files for later use. Mimetypes are stored into the given array.

Since
S60 3.0

Parameters

CArrayPtrFlat< CSendUiAttachment > * aAttachmentsAttachments (Path and handle) to be validated. Return value contains valid attachments, invalid attachments are filtered away from array.

ConfirmMmsValidityL(CArrayPtrFlat< CSendUiAttachment > *, TUid)

IMPORT_C voidConfirmMmsValidityL(CArrayPtrFlat< CSendUiAttachment > *aAttachments,
TUidaServiceId = KNullUid
)

Validates files for sending via MMS

Note: files must be validated before MMS validation.

Since
S60 3.0

Parameters

CArrayPtrFlat< CSendUiAttachment > * aAttachmentsAttachments to be validated. Return value contains valid attachments, invalid attachments are filtered away from array.
TUid aServiceId = KNullUidIdentifies the type of MMS service (MMS/MMS upload..)

ConstructL()

voidConstructL()[private]

By default Symbian 2nd phase constructor is private.

NewL(RFs &)

IMPORT_C CSendUiFileRightsEngine *NewL(RFs &aFs)[static]

Two-phased constructor.

Parameters

RFs & aFs

NewLC(RFs &)

IMPORT_C CSendUiFileRightsEngine *NewLC(RFs &aFs)[static]

Two-phased constructor.

Parameters

RFs & aFs

ResolveDrmQuery(TUid, TUint &)

voidResolveDrmQuery(TUidaServiceId,
TUint &aResourceId
)[private]
Resolves a proper DRM query for the given service
Since
S60 v.3.0

Parameters

TUid aServiceIdService Uid
TUint & aResourceIdId for a proper query in resources.

ResolveErrorNoteL(TUid, TUint &, TFREErrorNoteType &, TUint &)

voidResolveErrorNoteL(TUidaServiceId,
TUint &aResourceId,
TFREErrorNoteType &aNoteType,
TUint &aValueForNote
)[private]
Resolves a proper error note for the given service
Since
S60 v.3.0

Parameters

TUid aServiceIdService Uid
TUint & aResourceIdId for a proper note in resources.
TFREErrorNoteType & aNoteTypeType of the note (query/info)
TUint & aValueForNoteValue for the variable in the note

ResolveMmsUploadErrorNoteL(TUint &, TFREErrorNoteType &, TUint &)

voidResolveMmsUploadErrorNoteL(TUint &aResourceId,
TFREErrorNoteType &aNoteType,
TUint &aValueForNote
)[private]
Resolves a proper error note for the MMS Upload services
Since
S60 v.3.0

Parameters

TUint & aResourceIdId for a proper note in resources.
TFREErrorNoteType & aNoteTypeType of the note (query/info)
TUint & aValueForNoteValue for the variable in the note

ShowConfirmationQueryL(TUint, TUint, TUint)

TBool ShowConfirmationQueryL(TUintaTextResourceId,
TUintaNoteResourceId,
TUintaValueForNote = NULL
)const [private]
Shows a confirmation query
Since
S60 v.3.0

Parameters

TUint aTextResourceIdText id for the note
TUint aNoteResourceIdResource id for the note
TUint aValueForNote = NULLVariable value for the note

ShowDrmAndMmsInfoL(TUid)

IMPORT_C TBoolShowDrmAndMmsInfoL(TUidaServiceId = KNullUid)
Shows DRM confirmation query and/or error note, if needed. Returns EFalse if user cancels sending.
Since
S60 v.3.0

Parameters

TUid aServiceId = KNullUidDifferent services get different notes.

ShowErrorNoteL(TUint)

voidShowErrorNoteL(TUintaTextResourceId)const [private]
Shows an error note
Since
S60 v.3.0

Parameters

TUint aTextResourceIdResource id of the note

ShowErrorNotificationL(TUint, TFREErrorNoteType, TUint)

voidShowErrorNotificationL(TUintaResourceId,
TFREErrorNoteTypeaNoteType,
TUintaValueForNote
)const [private]
Resolves a proper note
Since
S60 v.3.0

Parameters

TUint aResourceIdId for a proper note in resources.
TFREErrorNoteType aNoteTypeType of the note
TUint aValueForNoteValue for the variable in the note

ShowInformationNoteL(TUint)

IMPORT_C voidShowInformationNoteL(TUintaTextResourceId)const
Shows an information note
Since
S60 v.3.0

Parameters

TUint aTextResourceIdResource id of the note

ValidateFile(const TDesC &, TInt &)

TBool ValidateFile(const TDesC &aFileName,
TInt &aFileSize
)[private]

Validates that the given file usable

Since
S60 v3.0

Parameters

const TDesC & aFileNamefile path
TInt & aFileSizefile size

ValidateFiles(CArrayPtrFlat< CSendUiAttachment > *)

IMPORT_C voidValidateFiles(CArrayPtrFlat< CSendUiAttachment > *aAttachments)

ValidateFiles

This functions stores file sizes for all validated files.

Since
S60 3.0

Parameters

CArrayPtrFlat< CSendUiAttachment > * aAttachmentsAttachents to be validated. Return value contains valid attachments, invalid attachments are filtered away from array.

Member Enumerations Documentation

Enum TFREInvalidTypes

Enumerators

ESenduiIndexDrmFLOrCCL = 0
ESenduiIndexAlreadyInUse
ESenduiIndexMmsTooBig
ESenduiIndexMmsNotSupported
ESenduiIndexBadHandle
ESenduiIndexLastInvalid

Enum TFREValidationResults

Enumerators

ESenduiIndexTotalCount = 0
ESenduiIndexDeleted
ESenduiIndexDrmSD
ESenduiIndexLastResult

Member Data Documentation

RFs iFileSession

RFs iFileSession[private]

TUint iInvalidationReason

TUint iInvalidationReason[private]

CMsgMediaResolver * iMediaResolver

CMsgMediaResolver *iMediaResolver[private]

CMmsConformance * iMmsConformance

CMmsConformance *iMmsConformance[private]

CFileProtectionResolver * iProtectionResolver

CFileProtectionResolver *iProtectionResolver[private]

TUint iValidationResults

TUint iValidationResults[private]

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.