Symbian^3 Product Developer Library >

CDRMHelper Class Reference

class CDRMHelper : public CBase

Handles some error situations DRM-aware applications may encounter.

drmhelper.lib
Since
Series 60 2.1

Inherits from

Public Member Functions
~CDRMHelper()
IMPORT_C voidActivateContentL(CData &)
IMPORT_C voidActivateContentL(TDesC &)
IMPORT_C TIntCanSetAutomated(const TDesC8 &, TBool &)
IMPORT_C TIntCanSetAutomated(const TDesC &, TBool &)
IMPORT_C TIntCanSetAutomated(RFile &, TBool &)
IMPORT_C TIntCheckRightsAmountL(const TDesC &, TInt, TInt)
IMPORT_C TIntCheckRightsAmountL(RFile &, TInt, TInt)
IMPORT_C TIntCheckRightsAmountL(const TDesC8 &, TInt, TInt)
IMPORT_C TIntCheckRightsPercentL(const TDesC &, TInt)
IMPORT_C TIntCheckRightsPercentL(RFile &, TInt)
IMPORT_C TIntConsume2(const TDesC8 &, TUint32, TDRMHelperConsumeAction)
IMPORT_C TIntConsumeFile2(const TDesC &, TUint32, TDRMHelperConsumeAction)
IMPORT_C TIntConsumeFile2(RFile &, TUint32, TDRMHelperConsumeAction)
IMPORT_C TIntDataTypesCount(TInt &)
IMPORT_C TBoolEmbeddedPreviewCompletedL(CData &)
IMPORT_C TBoolEmbeddedPreviewCompletedL(TDesC &)
IMPORT_C TIntGetContentURIList(RPointerArray< HBufC8 > *&)
IMPORT_C voidGetPreviewRightsL(CData &)
IMPORT_C voidGetPreviewRightsL(TDesC &)
IMPORT_C voidGetRightsDetailsL(const TDesC &, TUint32, TBool &, TBool &, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&)
IMPORT_C voidGetRightsDetailsL(RFile &, TUint32, TBool &, TBool &, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&)
IMPORT_C voidGetRightsDetailsL(const TDesC &, TUint32, TBool &, TBool &, CDRMRightsConstraints *&, CDRMRightsConstraints *&, CDRMRightsConstraints *&, CDRMRightsConstraints *&)
IMPORT_C voidGetRightsDetailsL(RFile &, TUint32, TBool &, TBool &, CDRMRightsConstraints *&, CDRMRightsConstraints *&, CDRMRightsConstraints *&, CDRMRightsConstraints *&)
IMPORT_C TIntHandleErrorL(TInt, const TDesC8 &)
IMPORT_C TIntHandleErrorL(TInt, const TDesC &)
IMPORT_C TIntHandleErrorL(TInt, RFile &)
IMPORT_C TIntHandleErrorOrPreviewL(TInt, RFile &, HBufC8 *&)
IMPORT_C TIntHandleErrorOrPreviewL(TInt, const TDesC &, HBufC8 *&)
IMPORT_C TBoolHasInfoUrlL(CData &, HBufC8 *&)
IMPORT_C TBoolHasInfoUrlL(TDesC &, HBufC8 *&)
IMPORT_C TDRMHelperPreviewTypeHasPreviewL(CData &, HBufC8 *&)
IMPORT_C TDRMHelperPreviewTypeHasPreviewL(TDesC &, HBufC8 *&)
IMPORT_C voidIndicateIdle()
IMPORT_C voidLaunchDetailsViewEmbeddedL(const TDesC8 &)
IMPORT_C voidLaunchDetailsViewEmbeddedL(const TDesC &)
IMPORT_C voidLaunchDetailsViewEmbeddedL(RFile &)
IMPORT_C voidLaunchDetailsViewEmbeddedL(const HBufC8 *)
IMPORT_C CDRMHelper *NewL(CCoeEnv &)
IMPORT_C CDRMHelper *NewL()
IMPORT_C CDRMHelper *NewL(CCoeEnv &, RFs &)
IMPORT_C CDRMHelper *NewL(RFs &)
IMPORT_C CDRMHelper *NewLC(CCoeEnv &)
IMPORT_C CDRMHelper *NewLC()
IMPORT_C CDRMHelper *NewLC(CCoeEnv &, RFs &)
IMPORT_C CDRMHelper *NewLC(RFs &)
IMPORT_C voidOpenInfoUrlL(CData &)
IMPORT_C voidOpenInfoUrlL(TDesC &)
IMPORT_C TIntRegisterDataType(const TDataType &)
IMPORT_C TIntRemoveAutomated(const TDesC8 &)
IMPORT_C TIntRemoveAutomated(const TDesC &)
IMPORT_C TIntRemoveAutomated(RFile &)
IMPORT_C TIntRemoveAutomatedPassive(const TDesC8 &)
IMPORT_C TIntRemoveAutomatedPassive(const TDesC &)
IMPORT_C TIntRemoveAutomatedPassive(RFile &)
IMPORT_C TIntSetAutomated(const TDesC8 &)
IMPORT_C TIntSetAutomated(const TDesC &)
IMPORT_C TIntSetAutomated(RFile &)
IMPORT_C TIntSetAutomatedPassive(const TDesC8 &)
IMPORT_C TIntSetAutomatedPassive(const TDesC &)
IMPORT_C TIntSetAutomatedPassive(RFile &)
IMPORT_C TIntSetAutomatedSilent(const TDesC8 &, TBool)
IMPORT_C TIntSetAutomatedSilent(const TDesC &, TBool)
IMPORT_C TIntSetAutomatedSilent(RFile &, TBool)
IMPORT_C TIntSetAutomatedType(TDRMHelperAutomatedType)
IMPORT_C voidSetCountLimitL(TUint)
IMPORT_C voidSetPercentageLimitL(TUint)
IMPORT_C TIntSetPreviewMediaType(TDRMHelperPreviewMediaType)
IMPORT_C voidSetTimeLimitL(TUint)
IMPORT_C TIntShowAutomatedNote(const TDesC8 &)
IMPORT_C TIntShowAutomatedNote(const TDesC &)
IMPORT_C TIntShowAutomatedNote(RFile &)
IMPORT_C TIntShowDRMUINotification2L(TDRMHelperNotificationID, const TDesC8 &)
IMPORT_C TIntShowDRMUINotification2L(TDRMHelperNotificationID, const TDesC &)
IMPORT_C TIntSupportedDRMMethods2(TInt &, TDRMHelperOMALevel &)
IMPORT_C TIntSupportedDataType(const TInt, TDataType &)
IMPORT_C TIntUnRegisterDataType(const TInt)
Private Member Functions
CDRMHelper(CCoeEnv &)
CDRMHelper()
TInt AutomatedResIdL(TBool, TBool, TUint32)
TBool BrowserAPDefinedL()
TInt CalculateEndTime(CDRMRights *, TInt, TTime &, TBool &)
voidCancelSecondaryDisplayL(TInt)
voidCheckPreviewUriL(const CData *, HBufC *&, TInt &)
voidConstructL(RFs *)
voidCreateLaunchParamL(TUint32, const HBufC8 *, HBufC *&)
voidDisplayInfoNoteL(TInt)
voidDisplayInfoNoteL(TInt, const TDesC &)
voidDisplayInfoNoteL(TInt, TInt)
voidDisplayInfoNoteL(TDesC &, TInt, const TDesC &, TInt)
TInt DisplayPopupWindowsForPreviewL(TInt)
TInt DisplayQueryL(TInt, TInt)
TInt DisplayQueryL(TInt, const TDesC &)
TInt DisplayQueryL(TInt, const TDesC &, TInt, TInt, TInt)
TInt DisplayQueryL(TDesC &, TInt)
TInt DisplayQueryWithIdL(TInt, TInt)
TInt DisplayQueryWithIdValueL(TInt, TInt, const TDesC &)
TInt DoCanSetAutomated(const TDesC8 &, const HBufC *, TBool &)
TInt DoCheckRightsAmountL(HBufC8 *, HBufC *, HBufC *, const TDesC &, TInt, TInt)
TInt DoCheckRightsPercentL(HBufC8 *, HBufC *, HBufC *, const TDesC &, TInt)
TBool DoCheckSkinCanSetAutomated(CDRMRights *)
voidDoGetRightsDetailsL(HBufC8 *, TUint32, TBool &, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&)
voidDoGetRightsDetailsL(CData *, TUint32, TBool &, TBool &, CDRMRightsConstraints *&, CDRMRightsConstraints *&, CDRMRightsConstraints *&, CDRMRightsConstraints *&)
TInt DoHandleErrorL(TInt, HBufC8 *, HBufC *, HBufC *, HBufC *, HBufC *, HBufC8 *, HBufC8 *, const TDesC &)
TInt DoSetAutomatedL(const TDesC8 &, TBool, const HBufC *)
TInt DoSetAutomatedSilent(const TDesC8 &, TBool, TInt)
TInt DoShowAutomatedNoteL(const TDesC8 &, const HBufC *)
TInt ErrorResIdL(const TDesC8 &, TInt, TBool, TBool)
voidGetConstraintsL(CDRMRights &, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&)
TInt GetCounts(CDRMRightsConstraints *, TUint32 &, TTimeIntervalDays &)
TInt GetCounts(CDRMRightsConstraints *, TUint32 &, TTime &)
TInt GetCounts(CDRMConstraint *, TUint32 &, TTimeIntervalDays &)
TInt GetCounts(CDRMConstraint *, TUint32 &, TTime &)
TInt GetEndTime(CDRMRightsConstraints *, TTime &, TBool &)
TInt GetExpirationDetails(HBufC8 *, TInt, CDRMRights *&)
TInt GetFileHandleFromURIL(const TDesC8 &, RFile &)
voidGetRightsIssuerL(const CData &, HBufC *&)
TInt GetSilentRightsL(const TDesC8 &)
TInt GetStartTime(CDRMRights *, TInt, TTime &)
voidHandleServerAppExit(TInt)
HBufC8 *HasSilentRightsUrlL(CData *)
TInt Intent(const HBufC *)
voidLaunchBrowserL(HBufC8 *)
voidLaunchBrowserL(HBufC *)
voidLaunchRightsManagerUiL(const TDesC &)
HBufC *MimeTypeFromURIL(const TDesC8 &)
TInt PerformCanSetAutomatedL(const CData &, TBool &)
TInt PerformRemoveAutomatedL(const CData &, TBool)
TInt PerformSetAutomatedL(const CData &, TBool)
TInt PerformSetAutomatedSilentL(const CData &, TBool)
TInt PerformShowAutomatedNoteL(const CData &)
voidPrepareSecondaryDisplayL(CEikDialog &, TInt, const TDesC &, TInt)
TUint32 RejectReasonL(TInt, const TDesC8 &)
TInt ShowFutureNoteL(const HBufC *, CDRMRights *)
TBool SilentRightsAllowedL()
TPtrC StripPathAndExtension(const TDesC &)
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
enumTDRMHelperAutomatedType {
EAutomatedTypeRingingTone, EAutomatedTypeMessageAlert, EAutomatedTypeEmailAlert, EAutomatedTypeIMAlert, EAutomatedTypeCalendarAlarm, EAutomatedTypeScreenSaver, EAutomatedTypeWallpaper, EAutomatedTypeTheme, EAutomatedTypeClockAlarm, EAutomatedTypeOther = KMaxTUint8
}
enumTDRMHelperConsumeAction { EStart, EFinish, EPause, EContinue }
enumTDRMHelperDRMMethods { EForwardLock = 0x0001, ECombinedDelivery = 0x0002, ESeparateDelivery = 0x0004, ESuperDistribution = 0x0008 }
enumTDRMHelperNotificationID { ETActivateTextId = 1, ETCountBasedErrorTextId = 2, ETCountUsageReduceId = 3, ETCountUsageReduceMediaId = 4 }
enumTDRMHelperOMALevel { EOMA_None, EOMA_1_0, EOMA_2_0 }
enumTDRMHelperPreviewType { ENoPreview, EEmbeddedPreview, EPreviewRights }
Private Attributes
TInt iAutomatedType
CCoeEnv *iCoeEnv
RPointerArray< CConsumeData >iConsumeList
DRMCommon *iDRMCommon
CMediatorEventProvider *iEventProvider
RFs iFs
TBool iFsOwned
RDRMHelper iHelperServer
RPointerArray< CDRMHelperInfoNoteWrapper >iNoteList
TBool iOma2
TInt iPreviewMediaType
TBool iReturnCancel
CSchemeHandler *iSchemeHandler
CStringResourceReader *iStringResourceReader
TBool iUseCoeEnv
CActiveSchedulerWait iWait

Constructor & Destructor Documentation

CDRMHelper(CCoeEnv &)

CDRMHelper(CCoeEnv &aCoeEnv)[private]
?member_description.
Since
?Series60_version

Parameters

CCoeEnv & aCoeEnv

CDRMHelper()

CDRMHelper()[private]

~CDRMHelper()

IMPORT_C~CDRMHelper()

Destructor.

Member Functions Documentation

ActivateContentL(CData &)

IMPORT_C voidActivateContentL(CData &aContent)

Acquires rights for given content if rights have been expired or rights are missing. If content already has valid or future rights, does nothing. This function should be called when user selects activate from options menu. Leaves with system-wide error code in case of error.

Parameters

CData & aContent

ActivateContentL(TDesC &)

IMPORT_C voidActivateContentL(TDesC &aFileName)

Acquires rights for given content if rights have been expired or rights are missing. If content already has valid or future rights, does nothing. This function should be called when user selects activate from options menu. Leaves with system-wide error code in case of error.

Parameters

TDesC & aFileName

AutomatedResIdL(TBool, TBool, TUint32)

TInt AutomatedResIdL(TBoolaExpired,
TBoolaSecondParameter,
TUint32aRejectReason
)[private]

Returns correct resource id for automated content notes. If aExpired is ETrue, aSecondParameter indicates if RI URL exists If aExpired is EFalse, aSecondParameter indicates if there is one day left aRejectReason tells the constraints which are invalid.

Parameters

TBool aExpired
TBool aSecondParameter
TUint32 aRejectReason

BrowserAPDefinedL()

TBool BrowserAPDefinedL()[private]

Check if browser AP has been defined

CalculateEndTime(CDRMRights *, TInt, TTime &, TBool &)

TInt CalculateEndTime(CDRMRights *aRights,
TIntaIntent,
TTime &aEndTime,
TBool &aInactive
)[private]

Get expiration time of given rights object

Parameters

CDRMRights * aRights
TInt aIntent
TTime & aEndTime
TBool & aInactive

CanSetAutomated(const TDesC8 &, TBool &)

IMPORT_C TIntCanSetAutomated(const TDesC8 &aURI,
TBool &aValue
)
Checks if given content can be set as an automated content.
Since
Series 60 2.6

Parameters

const TDesC8 & aURI
TBool & aValue

CanSetAutomated(const TDesC &, TBool &)

IMPORT_C TIntCanSetAutomated(const TDesC &aFilename,
TBool &aValue
)
Checks if given content can be set as an automated content.
Since
Series 60 2.6

Parameters

const TDesC & aFilename
TBool & aValue

CanSetAutomated(RFile &, TBool &)

IMPORT_C TIntCanSetAutomated(RFile &aFileHandle,
TBool &aValue
)
Checks if given content can be set as an automated content.
Since
3.0

Parameters

RFile & aFileHandle
TBool & aValue

CancelSecondaryDisplayL(TInt)

voidCancelSecondaryDisplayL(TIntaResourceId)[private]

Cancels secondary display for DRM notes

Parameters

TInt aResourceId

CheckPreviewUriL(const CData *, HBufC *&, TInt &)

voidCheckPreviewUriL(const CData *aContent,
HBufC *&aEmbeddedPreviewUri,
TInt &aPreviewType
)[private]

Parameters

const CData * aContent
HBufC *& aEmbeddedPreviewUri
TInt & aPreviewType

CheckRightsAmountL(const TDesC &, TInt, TInt)

IMPORT_C TIntCheckRightsAmountL(const TDesC &aFileName,
TIntaCount =  KDRMHelperDefaultCountThreshold ,
TIntaDays =  KDRMHelperDefaultTimeThreshold
)
Check rights for the content. If there is less than given amount of usage time/count left, appropriate note is displayed depending on situation.
Since
3.0 Check rights for the file. If there is less than given amount of usage time/count left, one of the following note is displayed depending on situation: 'Usage rights about to expire. View details?' 'Usage rights about to expire. N days left. View details?' 'Usage rights about to expire. 1 day left. View details?' 'Usage rights about to expire. N counts left. View details?' 'Usage rights about to expire. 1 count left. View details?' It also checks that rights are valid and displays appropriate note, if they are not.

Parameters

const TDesC & aFileName
TInt aCount =  KDRMHelperDefaultCountThreshold
TInt aDays =  KDRMHelperDefaultTimeThreshold

CheckRightsAmountL(RFile &, TInt, TInt)

IMPORT_C TIntCheckRightsAmountL(RFile &aFileHandle,
TIntaCount =  KDRMHelperDefaultCountThreshold ,
TIntaDays =  KDRMHelperDefaultTimeThreshold
)
Check rights for the file. If there is less than given amount of usage time/count left, one of the following note is displayed depending on situation: 'Usage rights about to expire. View details?' 'Usage rights about to expire. N days left. View details?' 'Usage rights about to expire. 1 day left. View details?' 'Usage rights about to expire. N counts left. View details?' 'Usage rights about to expire. 1 count left. View details?' It also checks that rights are valid and displays appropriate note, if they are not.
Since
3.0

Parameters

RFile & aFileHandle
TInt aCount =  KDRMHelperDefaultCountThreshold
TInt aDays =  KDRMHelperDefaultTimeThreshold

CheckRightsAmountL(const TDesC8 &, TInt, TInt)

IMPORT_C TIntCheckRightsAmountL(const TDesC8 &aUri,
TIntaCount =  KDRMHelperDefaultCountThreshold ,
TIntaDays =  KDRMHelperDefaultTimeThreshold
)

Check rights for the file. If there is less than given amount of usage time/count left, one of the following note is displayed depending on situation: 'Usage rights about to expire. View details?' 'Usage rights about to expire. N days left. View details?' 'Usage rights about to expire. 1 day left. View details?' 'Usage rights about to expire. N counts left. View details?' 'Usage rights about to expire. 1 count left. View details?' It also checks that rights are valid and displays appropriate note, if they are not.

Parameters

const TDesC8 & aUri
TInt aCount =  KDRMHelperDefaultCountThreshold
TInt aDays =  KDRMHelperDefaultTimeThreshold

CheckRightsPercentL(const TDesC &, TInt)

IMPORT_C TIntCheckRightsPercentL(const TDesC &aFileName,
TIntaThreshold =  KDRMHelperDefaultPercentageThreshold
)

Check rights for the file. If there is less than aThreshold percent of usage time/count left, one of the following note is displayed depending on situation: 'Usage rights about to expire. View details?' 'Usage rights about to expire. N days left. View details?' 'Usage rights about to expire. 1 day left. View details?' 'Usage rights about to expire. N counts left. View details?' 'Usage rights about to expire. 1 count left. View details?' It also checks that rights are valid and displays appropriate note, if they are not.

Parameters

const TDesC & aFileName
TInt aThreshold =  KDRMHelperDefaultPercentageThreshold

CheckRightsPercentL(RFile &, TInt)

IMPORT_C TIntCheckRightsPercentL(RFile &aFileHandle,
TIntaThreshold =  KDRMHelperDefaultPercentageThreshold
)
Check rights for the file. If there is less than aThreshold percent of usage time/count left, one of the following note is displayed depending on situation: 'Usage rights about to expire. View details?' 'Usage rights about to expire. N days left. View details?' 'Usage rights about to expire. 1 day left. View details?' 'Usage rights about to expire. N counts left. View details?' 'Usage rights about to expire. 1 count left. View details?' It also checks that rights are valid and displays appropriate note, if they are not.
Since
3.0

Parameters

RFile & aFileHandle
TInt aThreshold =  KDRMHelperDefaultPercentageThreshold

ConstructL(RFs *)

voidConstructL(RFs *aFs)[private]

By default Symbian 2nd phase constructor is private.

Parameters

RFs * aFs

Consume2(const TDesC8 &, TUint32, TDRMHelperConsumeAction)

IMPORT_C TIntConsume2(const TDesC8 &aContentURI,
TUint32aRightsSpec,
TDRMHelperConsumeActionanAction
)

Consume2

Overrides any rights consumption. This function must only be used by applications with user interaction and not by intermediate components. The main use cases are signalling that content is to be installed (including thumbnail generation), or that content is to be consumed. They are characterized as calls to this function with the correct intent (i.e. EPlay or EInstall) and the corresponding action (i.e. telling whether the indicated intent is started or finished). Calls to this function must be the result of a user interaction or otherwise high level event.

Since
3.0

Parameters

const TDesC8 & aContentURI
TUint32 aRightsSpec
TDRMHelperConsumeAction anAction

ConsumeFile2(const TDesC &, TUint32, TDRMHelperConsumeAction)

IMPORT_C TIntConsumeFile2(const TDesC &aFileName,
TUint32aRightsSpec,
TDRMHelperConsumeActionanAction
)

ConsumeFile2

Overrides any rights consumption. This function must only be used by applications with user interaction and not by intermediate components. The main use cases are signalling that content is to be installed (including thumbnail generation), or that content is to be consumed. They are characterized as calls to this function with the correct intent (i.e. EPlay or EInstall) and the corresponding action (i.e. telling whether the indicated intent is started or finished). Calls to this function must be the result of a user interaction or otherwise high level event.

Since
3.0

Parameters

const TDesC & aFileName
TUint32 aRightsSpec
TDRMHelperConsumeAction anAction

ConsumeFile2(RFile &, TUint32, TDRMHelperConsumeAction)

IMPORT_C TIntConsumeFile2(RFile &aFileHandle,
TUint32aRightsSpec,
TDRMHelperConsumeActionanAction
)

ConsumeFile2

Overrides any rights consumption. This function must only be used by applications with user interaction and not by intermediate components. The main use cases are signalling that content is to be installed (including thumbnail generation), or that content is to be consumed. They are characterized as calls to this function with the correct intent (i.e. EPlay or EInstall) and the corresponding action (i.e. telling whether the indicated intent is started or finished). Calls to this function must be the result of a user interaction or otherwise high level event.

Since
3.0

Parameters

RFile & aFileHandle
TUint32 aRightsSpec
TDRMHelperConsumeAction anAction

CreateLaunchParamL(TUint32, const HBufC8 *, HBufC *&)

voidCreateLaunchParamL(TUint32aLocalId,
const HBufC8 *aUrl,
HBufC *&aLaunchParam
)[private]

Form string needed to launch rights manager UI embedded.

Parameters

TUint32 aLocalId
const HBufC8 * aUrl
HBufC *& aLaunchParam

DataTypesCount(TInt &)

IMPORT_C TIntDataTypesCount(TInt &aCount)

DataTypesCount

Returns the number of previously registered datatypes which are supported by the DRM system and associated applications.

Since
2.0

Parameters

TInt & aCount

DisplayInfoNoteL(TInt)

voidDisplayInfoNoteL(TIntaTextResourceId)[private]

Display information note

Parameters

TInt aTextResourceId

DisplayInfoNoteL(TInt, const TDesC &)

voidDisplayInfoNoteL(TIntaTextResourceId,
const TDesC &aString
)[private]

Parameters

TInt aTextResourceId
const TDesC & aString

DisplayInfoNoteL(TInt, TInt)

voidDisplayInfoNoteL(TIntaTextResourceId,
TIntaValue
)[private]

Parameters

TInt aTextResourceId
TInt aValue

DisplayInfoNoteL(TDesC &, TInt, const TDesC &, TInt)

voidDisplayInfoNoteL(TDesC &aPromptText,
TIntaResourceId,
const TDesC &aString =  KNullDesC ,
TIntaValue = -1
)[private]

Parameters

TDesC & aPromptText
TInt aResourceId
const TDesC & aString =  KNullDesC
TInt aValue = -1

DisplayPopupWindowsForPreviewL(TInt)

TInt DisplayPopupWindowsForPreviewL(TIntaPreviewType)[private]

Parameters

TInt aPreviewType

DisplayQueryL(TInt, TInt)

TInt DisplayQueryL(TIntaTextResourceId,
TIntaValue
)[private]

Parameters

TInt aTextResourceId
TInt aValue

DisplayQueryL(TInt, const TDesC &)

TInt DisplayQueryL(TIntaTextResourceId,
const TDesC &aString
)[private]

Parameters

TInt aTextResourceId
const TDesC & aString

DisplayQueryL(TInt, const TDesC &, TInt, TInt, TInt)

TInt DisplayQueryL(TIntaTextResourceId,
const TDesC &aString,
TIntaValue,
TIntaStringPos = -1,
TIntaValuePos = -1
)[private]

Parameters

TInt aTextResourceId
const TDesC & aString
TInt aValue
TInt aStringPos = -1
TInt aValuePos = -1

DisplayQueryL(TDesC &, TInt)

TInt DisplayQueryL(TDesC &aPromptText,
TIntaQueryResourceId
)[private]

Parameters

TDesC & aPromptText
TInt aQueryResourceId

DisplayQueryWithIdL(TInt, TInt)

TInt DisplayQueryWithIdL(TIntaTextResourceId,
TIntaQueryResourceId
)[private]

Display query dialog

Parameters

TInt aTextResourceId
TInt aQueryResourceId

DisplayQueryWithIdValueL(TInt, TInt, const TDesC &)

TInt DisplayQueryWithIdValueL(TIntaTextResourceId,
TIntaQueryResourceId,
const TDesC &aString
)[private]

Parameters

TInt aTextResourceId
TInt aQueryResourceId
const TDesC & aString

DoCanSetAutomated(const TDesC8 &, const HBufC *, TBool &)

TInt DoCanSetAutomated(const TDesC8 &aURI,
const HBufC *aMimeType,
TBool &aValue
)[private]

Parameters

const TDesC8 & aURI
const HBufC * aMimeType
TBool & aValue

DoCheckRightsAmountL(HBufC8 *, HBufC *, HBufC *, const TDesC &, TInt, TInt)

TInt DoCheckRightsAmountL(HBufC8 *aContentUri,
HBufC *aMimeType,
HBufC *aRIUrl,
const TDesC &aFileName,
TIntaCount,
TIntaDays
)[private]

Parameters

HBufC8 * aContentUri
HBufC * aMimeType
HBufC * aRIUrl
const TDesC & aFileName
TInt aCount
TInt aDays

DoCheckRightsPercentL(HBufC8 *, HBufC *, HBufC *, const TDesC &, TInt)

TInt DoCheckRightsPercentL(HBufC8 *aContentUri,
HBufC *aMimeType,
HBufC *aRIUrl,
const TDesC &aFileName,
TIntaThreshold
)[private]

Checks if rights are about to expire.

Parameters

HBufC8 * aContentUri
HBufC * aMimeType
HBufC * aRIUrl
const TDesC & aFileName
TInt aThreshold

DoCheckSkinCanSetAutomated(CDRMRights *)

TBool DoCheckSkinCanSetAutomated(CDRMRights *aRights)[private]

Parameters

CDRMRights * aRights

DoGetRightsDetailsL(HBufC8 *, TUint32, TBool &, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&)

voidDoGetRightsDetailsL(HBufC8 *aContentUri,
TUint32aIntent,
TBool &aExpired,
CDRMHelperRightsConstraints *&aPlay,
CDRMHelperRightsConstraints *&aDisplay,
CDRMHelperRightsConstraints *&aExecute,
CDRMHelperRightsConstraints *&aPrint
)[private]

Gets rights details.

Parameters

HBufC8 * aContentUri
TUint32 aIntent
TBool & aExpired
CDRMHelperRightsConstraints *& aPlay
CDRMHelperRightsConstraints *& aDisplay
CDRMHelperRightsConstraints *& aExecute
CDRMHelperRightsConstraints *& aPrint

DoGetRightsDetailsL(CData *, TUint32, TBool &, TBool &, CDRMRightsConstraints *&, CDRMRightsConstraints *&, CDRMRightsConstraints *&, CDRMRightsConstraints *&)

voidDoGetRightsDetailsL(CData *aContent,
TUint32aIntent,
TBool &aExpired,
TBool &aSendingAllowed,
CDRMRightsConstraints *&aPlay,
CDRMRightsConstraints *&aDisplay,
CDRMRightsConstraints *&aExecute,
CDRMRightsConstraints *&aPrint
)[private]

Parameters

CData * aContent
TUint32 aIntent
TBool & aExpired
TBool & aSendingAllowed
CDRMRightsConstraints *& aPlay
CDRMRightsConstraints *& aDisplay
CDRMRightsConstraints *& aExecute
CDRMRightsConstraints *& aPrint

DoHandleErrorL(TInt, HBufC8 *, HBufC *, HBufC *, HBufC *, HBufC *, HBufC8 *, HBufC8 *, const TDesC &)

TInt DoHandleErrorL(TIntaError,
HBufC8 *aContentUri,
HBufC *aMimeType,
HBufC *aRIUrl,
HBufC *aDomainRoUrl,
HBufC *aEta,
HBufC8 *aRiId8,
HBufC8 *aDomainId8,
const TDesC &aFileName
)[private]

Handles error by displaying appropriate note to user.

Parameters

TInt aError
HBufC8 * aContentUri
HBufC * aMimeType
HBufC * aRIUrl
HBufC * aDomainRoUrl
HBufC * aEta
HBufC8 * aRiId8
HBufC8 * aDomainId8
const TDesC & aFileName

DoSetAutomatedL(const TDesC8 &, TBool, const HBufC *)

TInt DoSetAutomatedL(const TDesC8 &aURI,
TBoolaActive,
const HBufC *aMimeType
)[private]

Parameters

const TDesC8 & aURI
TBool aActive
const HBufC * aMimeType

DoSetAutomatedSilent(const TDesC8 &, TBool, TInt)

TInt DoSetAutomatedSilent(const TDesC8 &aURI,
TBoolaActive,
TIntaIntent
)[private]

Parameters

const TDesC8 & aURI
TBool aActive
TInt aIntent

DoShowAutomatedNoteL(const TDesC8 &, const HBufC *)

TInt DoShowAutomatedNoteL(const TDesC8 &aURI,
const HBufC *aMimeType
)[private]

Parameters

const TDesC8 & aURI
const HBufC * aMimeType

EmbeddedPreviewCompletedL(CData &)

IMPORT_C TBoolEmbeddedPreviewCompletedL(CData &aContent)

This method should be called after embedded preview has been played. It asks from user if he/she wants to buy rights and acquires those if user agrees. Leaves with system-wide error code in case of error.

Parameters

CData & aContent

EmbeddedPreviewCompletedL(TDesC &)

IMPORT_C TBoolEmbeddedPreviewCompletedL(TDesC &aFileName)

This method should be called after embedded preview has been played. It asks from user if he/she wants to buy rights and acquires those if user agrees. Leaves with system-wide error code in case of error.

Parameters

TDesC & aFileName

ErrorResIdL(const TDesC8 &, TInt, TBool, TBool)

TInt ErrorResIdL(const TDesC8 &aContentUri,
TIntaIntent,
TBoolaRightsIssuer,
TBoolaExpired
)[private]

Returns the correct resource id for expired and no rights notes

Parameters

const TDesC8 & aContentUri
TInt aIntent
TBool aRightsIssuer
TBool aExpired

GetConstraintsL(CDRMRights &, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&)

voidGetConstraintsL(CDRMRights &aRights,
CDRMHelperRightsConstraints *&aPlay,
CDRMHelperRightsConstraints *&aDisplay,
CDRMHelperRightsConstraints *&aExecute,
CDRMHelperRightsConstraints *&aPrint
)[private]

Get constraints for given rights

Parameters

CDRMRights & aRights
CDRMHelperRightsConstraints *& aPlay
CDRMHelperRightsConstraints *& aDisplay
CDRMHelperRightsConstraints *& aExecute
CDRMHelperRightsConstraints *& aPrint

GetContentURIList(RPointerArray< HBufC8 > *&)

IMPORT_C TIntGetContentURIList(RPointerArray< HBufC8 > *&aURIList)

GetContentURIList

Returns a list of all content URIs that have rights in the rights database.

Since
2.5

Parameters

RPointerArray< HBufC8 > *& aURIList

GetCounts(CDRMRightsConstraints *, TUint32 &, TTimeIntervalDays &)

TInt GetCounts(CDRMRightsConstraints *aConstraint,
TUint32 &aOriginalCount,
TTimeIntervalDays &aDuration
)[private]

Get time and count based constraints

Parameters

CDRMRightsConstraints * aConstraint
TUint32 & aOriginalCount
TTimeIntervalDays & aDuration

GetCounts(CDRMRightsConstraints *, TUint32 &, TTime &)

TInt GetCounts(CDRMRightsConstraints *aConstraint,
TUint32 &aCountLeft,
TTime &aEndTime
)[private]

Parameters

CDRMRightsConstraints * aConstraint
TUint32 & aCountLeft
TTime & aEndTime

GetCounts(CDRMConstraint *, TUint32 &, TTimeIntervalDays &)

TInt GetCounts(CDRMConstraint *aConstraint,
TUint32 &aOriginalCount,
TTimeIntervalDays &aDuration
)[private]

Parameters

CDRMConstraint * aConstraint
TUint32 & aOriginalCount
TTimeIntervalDays & aDuration

GetCounts(CDRMConstraint *, TUint32 &, TTime &)

TInt GetCounts(CDRMConstraint *aConstraint,
TUint32 &aCountLeft,
TTime &aEndTime
)[private]

Parameters

CDRMConstraint * aConstraint
TUint32 & aCountLeft
TTime & aEndTime

GetEndTime(CDRMRightsConstraints *, TTime &, TBool &)

TInt GetEndTime(CDRMRightsConstraints *aConstraint,
TTime &aEndTime,
TBool &aInactive
)[private]

Get end time of given constraint

Parameters

CDRMRightsConstraints * aConstraint
TTime & aEndTime
TBool & aInactive

GetExpirationDetails(HBufC8 *, TInt, CDRMRights *&)

TInt GetExpirationDetails(HBufC8 *aContentUri,
TIntaIntent,
CDRMRights *&aRightsObject
)[private]

Get expiration details of file. Returns DRMCommon::ENoRights if no rights object found or CDRMRights::TExpiration value

Parameters

HBufC8 * aContentUri
TInt aIntent
CDRMRights *& aRightsObject

GetFileHandleFromURIL(const TDesC8 &, RFile &)

TInt GetFileHandleFromURIL(const TDesC8 &aURI,
RFile &aFileHandle
)[private]

Gets corresponding filename (including full path) based on content URI

Parameters

const TDesC8 & aURI
RFile & aFileHandle

GetPreviewRightsL(CData &)

IMPORT_C voidGetPreviewRightsL(CData &aContent)

Acquires preview rights for given content. Leaves with system-wide error code in case of error.

Parameters

CData & aContent

GetPreviewRightsL(TDesC &)

IMPORT_C voidGetPreviewRightsL(TDesC &aFileName)

Acquires preview rights for given content. Leaves with system-wide error code in case of error.

Parameters

TDesC & aFileName

GetRightsDetailsL(const TDesC &, TUint32, TBool &, TBool &, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&)

IMPORT_C voidGetRightsDetailsL(const TDesC &aFileName,
TUint32aIntent,
TBool &aExpired,
TBool &aSendingAllowed,
CDRMHelperRightsConstraints *&aPlay,
CDRMHelperRightsConstraints *&aDisplay,
CDRMHelperRightsConstraints *&aExecute,
CDRMHelperRightsConstraints *&aPrint
)

Gets details of rights object associated of given file.

leave
KErrArgument file is not DRM-protected.
leave
KErrCANoRights no rights
caferr.h caftypes.h

Parameters

const TDesC & aFileNameFull path to file
TUint32 aIntentContentAccess::EPlay, ContentAccess::EView, ContentAccess::EPrint or ContentAccess::EExecute
TBool & aExpiredETrue if rights are not valid. If this is ETrue and some constraints are returned, rights will become valid in future
TBool & aSendingAllowedETrue if content can be sent
CDRMHelperRightsConstraints *& aPlayplay constraints, must be deleted by caller
CDRMHelperRightsConstraints *& aDisplaydisplay constraints, must be deleted by caller
CDRMHelperRightsConstraints *& aExecuteexecute constraints, must be deleted by caller
CDRMHelperRightsConstraints *& aPrintprint constraints, must be deleted by caller

GetRightsDetailsL(RFile &, TUint32, TBool &, TBool &, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&, CDRMHelperRightsConstraints *&)

IMPORT_C voidGetRightsDetailsL(RFile &aFileHandle,
TUint32aIntent,
TBool &aExpired,
TBool &aSendingAllowed,
CDRMHelperRightsConstraints *&aPlay,
CDRMHelperRightsConstraints *&aDisplay,
CDRMHelperRightsConstraints *&aExecute,
CDRMHelperRightsConstraints *&aPrint
)

Gets details of rights object associated of given file.

leave
KErrArgument file is not DRM-protected.
leave
KErrCANoRights no rights
caferr.h caftypes.h
Since
3.0

Parameters

RFile & aFileHandlefile handle to the file
TUint32 aIntentContentAccess::EPlay, ContentAccess::EView, ContentAccess::EPrint or ContentAccess::EExecute
TBool & aExpiredETrue if rights are not valid. If this is ETrue and some constraints are returned, rights will become valid in future
TBool & aSendingAllowedETrue if content can be sent
CDRMHelperRightsConstraints *& aPlayplay constraints, must be deleted by caller
CDRMHelperRightsConstraints *& aDisplaydisplay constraints, must be deleted by caller
CDRMHelperRightsConstraints *& aExecuteexecute constraints, must be deleted by caller
CDRMHelperRightsConstraints *& aPrintprint constraints, must be deleted by caller

GetRightsDetailsL(const TDesC &, TUint32, TBool &, TBool &, CDRMRightsConstraints *&, CDRMRightsConstraints *&, CDRMRightsConstraints *&, CDRMRightsConstraints *&)

IMPORT_C voidGetRightsDetailsL(const TDesC &aFileName,
TUint32aIntent,
TBool &aExpired,
TBool &aSendingAllowed,
CDRMRightsConstraints *&aPlay,
CDRMRightsConstraints *&aDisplay,
CDRMRightsConstraints *&aExecute,
CDRMRightsConstraints *&aPrint
)

Gets details of rights object associated of given file.

leave
KErrArgument file is not DRM-protected.
leave
KErrCANoRights no rights
caferr.h caftypes.h

Parameters

const TDesC & aFileNameFull path to file
TUint32 aIntentContentAccess::EPlay, ContentAccess::EView, ContentAccess::EPrint or ContentAccess::EExecute
TBool & aExpiredETrue if rights are not valid. If this is ETrue and some constraints are returned, rights will become valid in future
TBool & aSendingAllowedETrue if content can be sent
CDRMRightsConstraints *& aPlayplay constraints, must be deleted by caller
CDRMRightsConstraints *& aDisplaydisplay constraints, must be deleted by caller
CDRMRightsConstraints *& aExecuteexecute constraints, must be deleted by caller
CDRMRightsConstraints *& aPrintprint constraints, must be deleted by caller

GetRightsDetailsL(RFile &, TUint32, TBool &, TBool &, CDRMRightsConstraints *&, CDRMRightsConstraints *&, CDRMRightsConstraints *&, CDRMRightsConstraints *&)

IMPORT_C voidGetRightsDetailsL(RFile &aFileHandle,
TUint32aIntent,
TBool &aExpired,
TBool &aSendingAllowed,
CDRMRightsConstraints *&aPlay,
CDRMRightsConstraints *&aDisplay,
CDRMRightsConstraints *&aExecute,
CDRMRightsConstraints *&aPrint
)

Gets details of rights object associated of given file.

leave
KErrArgument file is not DRM-protected.
leave
KErrCANoRights no rights
caferr.h caftypes.h
Since
3.0

Parameters

RFile & aFileHandlefile handle to the file
TUint32 aIntentContentAccess::EPlay, ContentAccess::EView, ContentAccess::EPrint or ContentAccess::EExecute
TBool & aExpiredETrue if rights are not valid. If this is ETrue and some constraints are returned, rights will become valid in future
TBool & aSendingAllowedETrue if content can be sent
CDRMRightsConstraints *& aPlayplay constraints, must be deleted by caller
CDRMRightsConstraints *& aDisplaydisplay constraints, must be deleted by caller
CDRMRightsConstraints *& aExecuteexecute constraints, must be deleted by caller
CDRMRightsConstraints *& aPrintprint constraints, must be deleted by caller

GetRightsIssuerL(const CData &, HBufC *&)

voidGetRightsIssuerL(const CData &aContent,
HBufC *&aIssuer
)[private]

Get rights-issuer URI from DCF file

Parameters

const CData & aContent
HBufC *& aIssuer

GetSilentRightsL(const TDesC8 &)

TInt GetSilentRightsL(const TDesC8 &aUrl)[private]

Get rights silently

Parameters

const TDesC8 & aUrl

GetStartTime(CDRMRights *, TInt, TTime &)

TInt GetStartTime(CDRMRights *aRights,
TIntaIntent,
TTime &aStartTime
)[private]

Get start time of given rights object

Parameters

CDRMRights * aRights
TInt aIntent
TTime & aStartTime

HandleErrorL(TInt, const TDesC8 &)

IMPORT_C TIntHandleErrorL(TIntaError,
const TDesC8 &aURI
)

Displays appropriate error note depending on error code.

Parameters

TInt aError
const TDesC8 & aURI

HandleErrorL(TInt, const TDesC &)

IMPORT_C TIntHandleErrorL(TIntaError,
const TDesC &aFileName
)

Displays: Handles error situations 'rights expired', 'no rights' and 'rights database corrupted'.

Parameters

TInt aError
const TDesC & aFileName

HandleErrorL(TInt, RFile &)

IMPORT_C TIntHandleErrorL(TIntaError,
RFile &aFileHandle
)
Displays: Handles error situations 'rights expired', 'no rights' and 'rights database corrupted'.
Since
3.0

Parameters

TInt aError
RFile & aFileHandle

HandleErrorOrPreviewL(TInt, RFile &, HBufC8 *&)

IMPORT_C TIntHandleErrorOrPreviewL(TIntaError,
RFile &aFile,
HBufC8 *&aEmbeddedPreviewUri
)
Handles DRM-specific error situations. Should be called instead of HandleErrorL if user should be asked to play embedded preview or get preview/silent rights if there is no valid rights and either embedded preview or preview rights are available.
Since
S60 3.1

Parameters

TInt aError
RFile & aFile
HBufC8 *& aEmbeddedPreviewUri

HandleErrorOrPreviewL(TInt, const TDesC &, HBufC8 *&)

IMPORT_C TIntHandleErrorOrPreviewL(TIntaError,
const TDesC &aFileName,
HBufC8 *&aEmbeddedPreviewUri
)
Handles DRM specific error situations. Should be called instead of HandleErrorL if user should be asked to play embedded preview or get preview/silent rights if there is no valid rights and either embedded preview or preview rights are available.
Since
S60 3.1

Parameters

TInt aError
const TDesC & aFileName
HBufC8 *& aEmbeddedPreviewUri

HandleServerAppExit(TInt)

voidHandleServerAppExit(TIntaReason)[private]

Parameters

TInt aReason

HasInfoUrlL(CData &, HBufC8 *&)

IMPORT_C TBoolHasInfoUrlL(CData &aContent,
HBufC8 *&aInfoUrl
)

Checks if given content has InfoUrl. Leaves with system-wide error code in case of error.

Parameters

CData & aContent
HBufC8 *& aInfoUrl

HasInfoUrlL(TDesC &, HBufC8 *&)

IMPORT_C TBoolHasInfoUrlL(TDesC &aFileName,
HBufC8 *&aInfoUrl
)

Checks if given content has InfoUrl. Leaves with system-wide error code in case of error.

Parameters

TDesC & aFileName
HBufC8 *& aInfoUrl

HasPreviewL(CData &, HBufC8 *&)

IMPORT_C TDRMHelperPreviewTypeHasPreviewL(CData &aContent,
HBufC8 *&aPreviewUri
)

Checks if given content has embedded preview or if it is possible to get preview rights for it. Leaves with system-wide error code in case of error.

Parameters

CData & aContent
HBufC8 *& aPreviewUri

HasPreviewL(TDesC &, HBufC8 *&)

IMPORT_C TDRMHelperPreviewTypeHasPreviewL(TDesC &aFileName,
HBufC8 *&aPreviewUri
)

Checks if given content has embedded preview or if it is possible to get preview rights for it. Leaves with system-wide error code in case of error.

Parameters

TDesC & aFileName
HBufC8 *& aPreviewUri

HasSilentRightsUrlL(CData *)

HBufC8 *HasSilentRightsUrlL(CData *aContent)[private]

Check whether a file as a silent rights URL which can be used, i.e the URL is valid and on the white list.

Parameters

CData * aContent

IndicateIdle()

IMPORT_C voidIndicateIdle()
Informs DRMHelper that idle-screen has been activated.
Since
Series 60 2.6

Intent(const HBufC *)

TInt Intent(const HBufC *aMimeType)[private]

Returns default intent for the mimetype

Parameters

const HBufC * aMimeType

LaunchBrowserL(HBufC8 *)

voidLaunchBrowserL(HBufC8 *aUrl)[private]

Launch browser embedded

Parameters

HBufC8 * aUrl

LaunchBrowserL(HBufC *)

voidLaunchBrowserL(HBufC *aUrl)[private]

Parameters

HBufC * aUrl

LaunchDetailsViewEmbeddedL(const TDesC8 &)

IMPORT_C voidLaunchDetailsViewEmbeddedL(const TDesC8 &aURI)

Launches DRM Rights Manager UI embedded with details view related to given content.

Parameters

const TDesC8 & aURI

LaunchDetailsViewEmbeddedL(const TDesC &)

IMPORT_C voidLaunchDetailsViewEmbeddedL(const TDesC &aFileName)

Launches DRM Rights Manager UI embedded with details view related to given file.

Parameters

const TDesC & aFileName

LaunchDetailsViewEmbeddedL(RFile &)

IMPORT_C voidLaunchDetailsViewEmbeddedL(RFile &aFileHandle)
Launches DRM Rights Manager UI embedded with details view related to given file.
Since
3.0

Parameters

RFile & aFileHandle

LaunchDetailsViewEmbeddedL(const HBufC8 *)

IMPORT_C voidLaunchDetailsViewEmbeddedL(const HBufC8 *aContentURI)

Launches DRM Rights Manager UI embedded with details view related to given content.

Parameters

const HBufC8 * aContentURI

LaunchRightsManagerUiL(const TDesC &)

voidLaunchRightsManagerUiL(const TDesC &aParam16)[private]

Launch rights manager UI

Parameters

const TDesC & aParam16

MimeTypeFromURIL(const TDesC8 &)

HBufC *MimeTypeFromURIL(const TDesC8 &aURI)[private]

Gets mimetype based on content URI

Parameters

const TDesC8 & aURI

NewL(CCoeEnv &)

IMPORT_C CDRMHelper *NewL(CCoeEnv &aCoeEnv)[static]

Two-phased constructor.

Parameters

CCoeEnv & aCoeEnv

NewL()

IMPORT_C CDRMHelper *NewL()[static]
Two-phased constructor.
Since
Series 60 2.6

NewL(CCoeEnv &, RFs &)

IMPORT_C CDRMHelper *NewL(CCoeEnv &aCoeEnv,
RFs &aFs
)[static]
Two-phased constructor.
Since
Series 60 3.0

Parameters

CCoeEnv & aCoeEnv
RFs & aFs

NewL(RFs &)

IMPORT_C CDRMHelper *NewL(RFs &aFs)[static]
Two-phased constructor.
Since
Series 60 3.0

Parameters

RFs & aFs

NewLC(CCoeEnv &)

IMPORT_C CDRMHelper *NewLC(CCoeEnv &aCoeEnv)[static]

Parameters

CCoeEnv & aCoeEnv

NewLC()

IMPORT_C CDRMHelper *NewLC()[static]

NewLC(CCoeEnv &, RFs &)

IMPORT_C CDRMHelper *NewLC(CCoeEnv &aCoeEnv,
RFs &aFs
)[static]

Parameters

CCoeEnv & aCoeEnv
RFs & aFs

NewLC(RFs &)

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

Parameters

RFs & aFs

OpenInfoUrlL(CData &)

IMPORT_C voidOpenInfoUrlL(CData &aContent)

Opens browser with InfoUrl of the content. Leaves with system-wide error code in case of error.

Parameters

CData & aContent

OpenInfoUrlL(TDesC &)

IMPORT_C voidOpenInfoUrlL(TDesC &aFileName)

Opens browser with InfoUrl of the content. Leaves with system-wide error code in case of error.

Parameters

TDesC & aFileName

PerformCanSetAutomatedL(const CData &, TBool &)

TInt PerformCanSetAutomatedL(const CData &aContent,
TBool &aValue
)[private]

Checks if content can be used as automated content

Parameters

const CData & aContent
TBool & aValue

PerformRemoveAutomatedL(const CData &, TBool)

TInt PerformRemoveAutomatedL(const CData &aContent,
TBoolaActive
)[private]

Unregisters automated content.

Parameters

const CData & aContent
TBool aActive

PerformSetAutomatedL(const CData &, TBool)

TInt PerformSetAutomatedL(const CData &aContent,
TBoolaActive
)[private]

Register content as automated

Parameters

const CData & aContent
TBool aActive

PerformSetAutomatedSilentL(const CData &, TBool)

TInt PerformSetAutomatedSilentL(const CData &aContent,
TBoolaActive
)[private]

Register content as automated without showing any queries

Parameters

const CData & aContent
TBool aActive

PerformShowAutomatedNoteL(const CData &)

TInt PerformShowAutomatedNoteL(const CData &aContent)[private]

Display confirmation query about setting as automated. Does not actually register.

Parameters

const CData & aContent

PrepareSecondaryDisplayL(CEikDialog &, TInt, const TDesC &, TInt)

voidPrepareSecondaryDisplayL(CEikDialog &aDialog,
TIntaResourceId,
const TDesC &aString =  KNullDesC ,
TIntaValue = -1
)[private]

Prepares secondary display for DRM notes

Parameters

CEikDialog & aDialog
TInt aResourceId
const TDesC & aString =  KNullDesC
TInt aValue = -1

RegisterDataType(const TDataType &)

IMPORT_C TIntRegisterDataType(const TDataType &aDataType)

RegisterDataType

Registers a datatype as a supported datatype.

Since
2.0

Parameters

const TDataType & aDataType

RejectReasonL(TInt, const TDesC8 &)

TUint32 RejectReasonL(TIntaIntent,
const TDesC8 &aContentUri
)[private]

Returns the constraints which are invalid

Parameters

TInt aIntent
const TDesC8 & aContentUri

RemoveAutomated(const TDesC8 &)

IMPORT_C TIntRemoveAutomated(const TDesC8 &aURI)
Unregisters given content to be used as an automated content.
Since
Series 60 2.6

Parameters

const TDesC8 & aURI

RemoveAutomated(const TDesC &)

IMPORT_C TIntRemoveAutomated(const TDesC &aFilename)
Unregisters given content to be used as an automated content.
Since
Series 60 2.6

Parameters

const TDesC & aFilename

RemoveAutomated(RFile &)

IMPORT_C TIntRemoveAutomated(RFile &aFileHandle)
Unregisters given content to be used as an automated content.
Since
3.0

Parameters

RFile & aFileHandle

RemoveAutomatedPassive(const TDesC8 &)

IMPORT_C TIntRemoveAutomatedPassive(const TDesC8 &aURI)
Unregisters given content to be used as an automated content. This function must be used when content was registered using SetAutomatedPassive.
Since
Series 60 2.6

Parameters

const TDesC8 & aURI

RemoveAutomatedPassive(const TDesC &)

IMPORT_C TIntRemoveAutomatedPassive(const TDesC &aFilename)
Unregisters given content to be used as an automated content. This function must be used when content was registered using SetAutomatedPassive.
Since
Series 60 2.6

Parameters

const TDesC & aFilename

RemoveAutomatedPassive(RFile &)

IMPORT_C TIntRemoveAutomatedPassive(RFile &aFileHandle)
Unregisters given content to be used as an automated content. This function must be used when content was registered using SetAutomatedPassive.
Since
3.0

Parameters

RFile & aFileHandle

SetAutomated(const TDesC8 &)

IMPORT_C TIntSetAutomated(const TDesC8 &aURI)
Registers given content to be used as an automated content. This function is used when registering application listens expiry notifications itself
Since
Series 60 2.6

Parameters

const TDesC8 & aURI

SetAutomated(const TDesC &)

IMPORT_C TIntSetAutomated(const TDesC &aFilename)
Registers given content to be used as an automated content. This function is used when registering application listens expiry notifications itself.
Since
Series 60 2.6

Parameters

const TDesC & aFilename

SetAutomated(RFile &)

IMPORT_C TIntSetAutomated(RFile &aFileHandle)
Registers given content to be used as an automated content. This function is used when registering application listens expiry
Since
3.0

Parameters

RFile & aFileHandle

SetAutomatedPassive(const TDesC8 &)

IMPORT_C TIntSetAutomatedPassive(const TDesC8 &aURI)
Registers given content to be used as an automated content. This function is used when phone application listens to expiry notifications.
Since
Series 60 2.6

Parameters

const TDesC8 & aURI

SetAutomatedPassive(const TDesC &)

IMPORT_C TIntSetAutomatedPassive(const TDesC &aFilename)
Registers given content to be used as an automated content. This function is used when phone application listens to expiry notifications.
Since
Series 60 2.6

Parameters

const TDesC & aFilename

SetAutomatedPassive(RFile &)

IMPORT_C TIntSetAutomatedPassive(RFile &aFileHandle)
Registers given content to be used as an automated content. This function is used when phone application listens to expiry notifications.
Since
3.0

Parameters

RFile & aFileHandle

SetAutomatedSilent(const TDesC8 &, TBool)

IMPORT_C TIntSetAutomatedSilent(const TDesC8 &aURI,
TBoolaActive
)
Registers given content to be used as an automated content without confirmation query.
Since
Series 60 2.6

Parameters

const TDesC8 & aURI
TBool aActive

SetAutomatedSilent(const TDesC &, TBool)

IMPORT_C TIntSetAutomatedSilent(const TDesC &aFilename,
TBoolaActive
)
Registers given content to be used as an automated content without confirmation query.
Since
Series 60 2.6

Parameters

const TDesC & aFilename
TBool aActive

SetAutomatedSilent(RFile &, TBool)

IMPORT_C TIntSetAutomatedSilent(RFile &aFileHandle,
TBoolaActive
)
Registers given content to be used as an automated content without confirmation query.
Since
3.0

Parameters

RFile & aFileHandle
TBool aActive

SetAutomatedType(TDRMHelperAutomatedType)

IMPORT_C TIntSetAutomatedType(TDRMHelperAutomatedTypeaAutomatedType)
Sets the type of automated content to be registered. This method should be called before calling any of SetAutomated* methods.
Since
Series 60 3.0

Parameters

TDRMHelperAutomatedType aAutomatedType

SetCountLimitL(TUint)

IMPORT_C voidSetCountLimitL(TUintaCounts)

Set count limit for CheckRightsAmountL

Parameters

TUint aCounts

SetPercentageLimitL(TUint)

IMPORT_C voidSetPercentageLimitL(TUintaPercentage)

Set percentage limit for CheckRightsAmountL. Applies to both counts and time.

Parameters

TUint aPercentage

SetPreviewMediaType(TDRMHelperPreviewMediaType)

IMPORT_C TIntSetPreviewMediaType(TDRMHelperPreviewMediaTypeaMediaType)
Sets media type of content for preview. Should be called prior to calling HandleErrorOrPreviewL or EmbeddedPreviewCompletedL.
Since
S60 3.1u

Parameters

TDRMHelperPreviewMediaType aMediaType

SetTimeLimitL(TUint)

IMPORT_C voidSetTimeLimitL(TUintaDays)

Set time limit in days for CheckRightsAmountL

Parameters

TUint aDays

ShowAutomatedNote(const TDesC8 &)

IMPORT_C TIntShowAutomatedNote(const TDesC8 &aURI)
Displays the confirmation query about setting given content as an automated content. Note that this function does not actually register content, just displays the note
Since
Series 60 2.6

Parameters

const TDesC8 & aURI

ShowAutomatedNote(const TDesC &)

IMPORT_C TIntShowAutomatedNote(const TDesC &aFilename)
Displays the confirmation query about setting given content as an automated content. Note that this function does not actually register content, just displays the note
Since
Series 60 2.6

Parameters

const TDesC & aFilename

ShowAutomatedNote(RFile &)

IMPORT_C TIntShowAutomatedNote(RFile &aFileHandle)
Displays the confirmation query about setting given content as an automated content. Note that this function does not actually register content, just displays the note
Since
3.0

Parameters

RFile & aFileHandle

ShowDRMUINotification2L(TDRMHelperNotificationID, const TDesC8 &)

IMPORT_C TIntShowDRMUINotification2L(TDRMHelperNotificationIDaTextId,
const TDesC8 &aURI
)
Handle the general UI based error notes
Since
3.0

Parameters

TDRMHelperNotificationID aTextIdThe code for DRM general notification note.
const TDesC8 & aURIThe DRM files URI, that caused the DRM error.

ShowDRMUINotification2L(TDRMHelperNotificationID, const TDesC &)

IMPORT_C TIntShowDRMUINotification2L(TDRMHelperNotificationIDaTextId,
const TDesC &aFileName
)
Handle the general UI based error notes
Since
3.0

Parameters

TDRMHelperNotificationID aTextIdThe code for DRM general notification note.
const TDesC & aFileNameThe DRM file's name and path, that caused the DRM error.

ShowFutureNoteL(const HBufC *, CDRMRights *)

TInt ShowFutureNoteL(const HBufC *aMimeType,
CDRMRights *aRightsObject
)[private]

Displays info note of rights that are not yet valid

Parameters

const HBufC * aMimeType
CDRMRights * aRightsObject

SilentRightsAllowedL()

TBool SilentRightsAllowedL()[private]

Check if the user has allowed silent rights

StripPathAndExtension(const TDesC &)

TPtrC StripPathAndExtension(const TDesC &aFileName)[private]

Strip path and extension from given filename. Caller is responsible for freeing returned buffer

Parameters

const TDesC & aFileName

SupportedDRMMethods2(TInt &, TDRMHelperOMALevel &)

IMPORT_C TIntSupportedDRMMethods2(TInt &aDRMMethod,
TDRMHelperOMALevel &aOMALevel
)

SupportedDRMMethods

Returns the supported DRM protection methods and the OMA compliance level of the DRM engine

Since
2.0

Parameters

TInt & aDRMMethod
TDRMHelperOMALevel & aOMALevel

SupportedDataType(const TInt, TDataType &)

IMPORT_C TIntSupportedDataType(const TIntaIndex,
TDataType &aDataType
)

SupportedDataType

Returns a specific datatype which has been registered before by giving an index

Since
2.0

Parameters

const TInt aIndex
TDataType & aDataType

UnRegisterDataType(const TInt)

IMPORT_C TIntUnRegisterDataType(const TIntaIndex)

UnRegisterDataType

Unregisters a datatype via its index.

Since
2.5

Parameters

const TInt aIndex

Member Enumerations Documentation

Enum TDRMHelperAutomatedType

Enumerators

EAutomatedTypeRingingTone
EAutomatedTypeMessageAlert
EAutomatedTypeEmailAlert
EAutomatedTypeIMAlert
EAutomatedTypeCalendarAlarm
EAutomatedTypeScreenSaver
EAutomatedTypeWallpaper
EAutomatedTypeTheme
EAutomatedTypeClockAlarm
EAutomatedTypeOther = KMaxTUint8

Enum TDRMHelperConsumeAction

Enumerators

EStart
EFinish
EPause
EContinue

Enum TDRMHelperDRMMethods

Enumerators

EForwardLock = 0x0001
ECombinedDelivery = 0x0002
ESeparateDelivery = 0x0004
ESuperDistribution = 0x0008

Enum TDRMHelperNotificationID

Enumerators

ETActivateTextId = 1
ETCountBasedErrorTextId = 2
ETCountUsageReduceId = 3
ETCountUsageReduceMediaId = 4

Enum TDRMHelperOMALevel

Enumerators

EOMA_None
EOMA_1_0
EOMA_2_0

Enum TDRMHelperPreviewType

Enumerators

ENoPreview
EEmbeddedPreview
EPreviewRights

Member Data Documentation

TInt iAutomatedType

TInt iAutomatedType[private]

CCoeEnv * iCoeEnv

CCoeEnv *iCoeEnv[private]

RPointerArray< CConsumeData > iConsumeList

RPointerArray< CConsumeData >iConsumeList[private]

DRMCommon * iDRMCommon

DRMCommon *iDRMCommon[private]

CMediatorEventProvider * iEventProvider

CMediatorEventProvider *iEventProvider[private]

RFs iFs

RFs iFs[private]

TBool iFsOwned

TBool iFsOwned[private]

RDRMHelper iHelperServer

RDRMHelper iHelperServer[private]

RPointerArray< CDRMHelperInfoNoteWrapper > iNoteList

RPointerArray< CDRMHelperInfoNoteWrapper >iNoteList[private]

TBool iOma2

TBool iOma2[private]

TInt iPreviewMediaType

TInt iPreviewMediaType[private]

TBool iReturnCancel

TBool iReturnCancel[private]

CSchemeHandler * iSchemeHandler

CSchemeHandler *iSchemeHandler[private]

CStringResourceReader * iStringResourceReader

CStringResourceReader *iStringResourceReader[private]

TBool iUseCoeEnv

TBool iUseCoeEnv[private]

CActiveSchedulerWait iWait

CActiveSchedulerWait iWait[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.