Symbian^3 Application Developer Library >

DRM::CDrmUtility Class Reference

class DRM::CDrmUtility : public CBase

DRM Utility base class

Provides essential information about the DRM protection of a file and the name of the CAF agent to be used without using CAF.

drmutility.lib
Since
S60 v5.0

Inherits from

Public Member Functions
~CDrmUtility ()
IMPORT_C void CheckFileHandleL ( RFile &)
IMPORT_C TBool GetAgentL ( RFile &, TPtrC &)
IMPORT_C TBool GetAgentL (const TDesC8 &, TPtrC &)
IMPORT_C TBool GetDrmInfoL ( RFile &, TPtrC &, TDrmProtectionStatus &)
IMPORT_C TBool GetDrmInfoL (const TDesC8 &, TPtrC &, TDrmProtectionStatus &)
IMPORT_C TBool IsProtectedL ( RFile &)
IMPORT_C TBool IsProtectedL (const TDesC8 &)
IMPORT_C CDrmUtility * NewL ()
IMPORT_C CDrmUtility * NewLC ()
Private Member Functions
CDrmUtility ()
void ConstructL ()
void FetchOmaBasedInfoL ()
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 Attributes
HBufC * iOmaBasedAgentName
HBufC8 * iOmaBasedMimeType

Constructor & Destructor Documentation

CDrmUtility()

CDrmUtility ( ) [private]

C++ default constructor.

~CDrmUtility()

~CDrmUtility ( ) [virtual]

Destructor.

Member Functions Documentation

CheckFileHandleL(RFile &)

IMPORT_C void CheckFileHandleL ( RFile & aFileHandle ) const

Checks if the given file handle is valid

Since
S60 5.0
leave
KErrBadHandle if the filehandle is invalid

Parameters

RFile & aFileHandle Filehandle to be examined

ConstructL()

void ConstructL ( ) [private]

FetchOmaBasedInfoL()

void FetchOmaBasedInfoL ( ) [private]

GetAgentL(RFile &, TPtrC &)

IMPORT_C TBool GetAgentL ( RFile & aFileHandle,
TPtrC & aAgent
) const

Checks what agent handles the given drm content file

Since
S60 5.0
leave
KErrBadHandle if the file handle is invalid System wide or DRM specific error code

Parameters

RFile & aFileHandle Open filehandle to the file to be examined
TPtrC & aAgent Name of the agent that handles the file

GetAgentL(const TDesC8 &, TPtrC &)

IMPORT_C TBool GetAgentL ( const TDesC8 & aContent,
TPtrC & aAgent
) const

Checks what agent handles the given drm content buffer

Since
S60 5.0
leave
KErrArgument, if there is not sufficient amount of data provided to the function to determine if the buffer has drm data System wide or DRM specific error code

Parameters

const TDesC8 & aContent Memory buffer containg the file (or part of it)
TPtrC & aAgent Name of the agent that handles the file

GetDrmInfoL(RFile &, TPtrC &, TDrmProtectionStatus &)

IMPORT_C TBool GetDrmInfoL ( RFile & aFileHandle,
TPtrC & aAgent,
TDrmProtectionStatus & aProtected
) const

Checks whether the given file belongs to a DRM protected content file

Since
S60 5.0
leave
KErrBadHandle if the file handle is invalid System wide or DRM specific error code

Parameters

RFile & aFileHandle Open filehandle to the file to be examined
TPtrC & aAgent Name of the agent that handles the file or KNullDesC if no agent is found
TDrmProtectionStatus & aProtected EProtected, if the default content object is protected EUnprotected, if the default content object is not protected

GetDrmInfoL(const TDesC8 &, TPtrC &, TDrmProtectionStatus &)

IMPORT_C TBool GetDrmInfoL ( const TDesC8 & aContent,
TPtrC & aAgent,
TDrmProtectionStatus & aProtected
) const

Checks whether the given buffer belongs to a DRM protected content file

Since
S60 5.0
leave
KErrArgument if there is not sufficient amount of data provided to the function to determine if the buffer has drm data System wide or DRM specific error code

Parameters

const TDesC8 & aContent Memory buffer containing the content (or part of it)
TPtrC & aAgent Name of the agent that handles the file or KNullDesC if no agent is found
TDrmProtectionStatus & aProtected EProtected, if the default content object is protected EUnprotected, if the default content object is not protected EUnknown, if there is not enough data to determine the protection status

IsProtectedL(RFile &)

IMPORT_C TBool IsProtectedL ( RFile & aFileHandle ) const

Checks whether the given file is a drm content file and if it's default content object is protected or not

Since
S60 5.0
leave
KErrBadHandle if the file handle is invalid System wide or DRM specific error code

Parameters

RFile & aFileHandle Open filehandle to the file to be examined

IsProtectedL(const TDesC8 &)

IMPORT_C TBool IsProtectedL ( const TDesC8 & aContent ) const

Checks whether the given buffer is a drm content and if it's default content object is protected or not

Since
S60 5.0
leave
KErrArgument, if there is not sufficient amount of data provided to the function to determine if the buffer has drm data and the protection status System wide or DRM specific error code

Parameters

const TDesC8 & aContent Memory buffer containing the content (or part of it)

NewL()

IMPORT_C CDrmUtility * NewL ( ) [static]

Two-phased constructor. Creates a new CDrmUtility -object

Since
S60 5.0
leave
System wide or DRM specific error code

NewLC()

IMPORT_C CDrmUtility * NewLC ( ) [static]

Two-phased constructor. Creates a new CDrmUtility -object and leaves it in the cleanup stack

Since
S60 5.0
leave
System wide or DRM specific error code

Member Data Documentation

HBufC * iOmaBasedAgentName

HBufC * iOmaBasedAgentName [private]

HBufC8 * iOmaBasedMimeType

HBufC8 * iOmaBasedMimeType [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.