Collapse all Symbian^3 Product 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

DRM::CDrmUtility
- CBase

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]