Collapse all Symbian^3 Product Developer Library

CDRMEventHandler Class Reference

class CDRMEventHandler : public CActive

CDRMEventHandler Performs the required operations between the client and the server Handles the handles for the observers

DRMCommon.dll

Since: S60Rel2.6

Inherits from

CDRMEventHandler
- CActive
  - CBase

Nested Classes and Structures

Public Member Functions
	~CDRMEventHandler()
CDRMEventHandler *	NewL()
void	RegisterEventObserverL(MDRMEventObserver &, const TDRMEventType &)
void	RegisterEventObserverL(MDRMEventObserver &, const TDRMEventType &, const TDesC8 &)
void	SendEventL(MDRMEvent &, TRequestStatus &)
void	UnRegisterEventObserverL(MDRMEventObserver &, const TDRMEventType &)
void	UnRegisterEventObserverL(MDRMEventObserver &, const TDRMEventType &, const TDesC8 &)

Protected Member Functions
	CDRMEventHandler()
void	ConstructL()
void	DoCancel()
void	RunL()

Private Member Functions
	CDRMEventHandler(const CDRMEventHandler &)
MDRMEvent *	GetEventObjectLC()
void	HandleRunL()
CDRMEventHandler &	operator=(const CDRMEventHandler &)

Inherited Functions
	CActive::CActive(TInt)
	CActive::Cancel()
	CActive::Deque()
	CActive::Extension_(TUint,TAny &,TAny )
	CActive::IsActive()const
	CActive::IsAdded()const
	CActive::Priority()const
	CActive::RunError(TInt)
	CActive::SetActive()
	CActive::SetPriority(TInt)
	CActive::~CActive()
	CBase::CBase()
	CBase::Delete(CBase *)
	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()

Inherited Enumerations
	CActive:TPriority

Private Attributes
CArrayPtrSeg< TObserverData > *	iAddRemoveObservers
TPtr8 *	iData
TUint8 *	iDataBuffer
CArrayPtrSeg< TDelayedObserverData > *	iDelayedObservers
TDRMEventType *	iEventType
TDRMEventType *	iEventTypeWait
RDRMNotifierClient *	iHandler
TBool	iIsDelayed
TBool	iIsOpen
CArrayPtrSeg< TObserverData > *	iModifyObservers
CArrayPtrSeg< TObserverData > *	iTimeChangeObservers
TPtr8 *	iWaitData
TUint8 *	iWaitDataBuffer

Inherited Attributes
	CActive::iStatus

Constructor & Destructor Documentation

CDRMEventHandler()

CDRMEventHandler

(

)

[protected]

CDRMEventHandler(const CDRMEventHandler &)

CDRMEventHandler

(

const CDRMEventHandler &

)

[private]

Parameters

const CDRMEventHandler &

~CDRMEventHandler()

~CDRMEventHandler

(

)

[virtual]

Destructor.

Member Functions Documentation

ConstructL()

void

ConstructL

(

)

[protected]

2nd phase constructor.

DoCancel()

void

DoCancel

(

)

[protected, virtual]

Implements cancellation of an outstanding request.

This function is called as part of the active object's Cancel().

It must call the appropriate cancel function offered by the active object's asynchronous service provider. The asynchronous service provider's cancel is expected to act immediately.

DoCancel() must not wait for event completion; this is handled by Cancel().

CActive::Cancel

GetEventObjectLC()

MDRMEvent *

GetEventObjectLC

(

)

[private]

GetEventObjectLC

Reserves memory for an object specified in the internal structure and leaves it in the cleanup stack

HandleRunL()

void

HandleRunL

(

)

[private]

HandleRunL

Helper function for RunL that does the actual callbacks to registered clients

NewL()

CDRMEventHandler *

NewL

(

)

[static]

Two-phased constructor.

RegisterEventObserverL(MDRMEventObserver &, const TDRMEventType &)

void	RegisterEventObserverL	(	MDRMEventObserver &	aObserver,
			const TDRMEventType &	aEvent
		)

RegisterEventObserverL

Registers a new event observer to DRM Notifier. Listens to all events of the given type

Since: S60Rel2.6

Parameters

MDRMEventObserver & aObserver	Observer.
const TDRMEventType & aEvent	the type of event to listen to

RegisterEventObserverL(MDRMEventObserver &, const TDRMEventType &, const TDesC8 &)

void	RegisterEventObserverL	(	MDRMEventObserver &	aObserver,
			const TDRMEventType &	aEvent,
			const TDesC8 &	aContentID
		)

RegisterEventObserverL

Registers a new event observer to DRM Notifier. Only recieves notification when the rights accociated with the given content id are handled

Since: S60Rel2.6

Parameters

MDRMEventObserver & aObserver	Observer
const TDRMEventType & aEvent	the type of event to listen to
const TDesC8 & aContentID	the specific content id to listen to

RunL()

void

RunL

(

)

[protected, virtual]

From CActive: RunL catches events from DRM server.

SendEventL(MDRMEvent &, TRequestStatus &)

void	SendEventL	(	MDRMEvent &	aEvent,
			TRequestStatus &	aStatus
		)

SendEventL

Sends a notification to registered observers, asyncronous

Since: S60Rel2.6

Parameters

MDRMEvent & aEvent	the event to send
TRequestStatus & aStatus	the request status of the event

UnRegisterEventObserverL(MDRMEventObserver &, const TDRMEventType &)

void	UnRegisterEventObserverL	(	MDRMEventObserver &	aObserver,
			const TDRMEventType &	aEvent
		)

UnRegisterEventObserverL

Unregisters existing event observer from DRM Notifier.

Since: S60Rel2.6

Parameters

MDRMEventObserver & aObserver	Observer.
const TDRMEventType & aEvent	the type of event to unregister

UnRegisterEventObserverL(MDRMEventObserver &, const TDRMEventType &, const TDesC8 &)

void	UnRegisterEventObserverL	(	MDRMEventObserver &	aObserver,
			const TDRMEventType &	aEvent,
			const TDesC8 &	aContentID
		)

UnRegisterEventObserverL

Unregisters existing event observer from DRM Notifier.

Since: S60Rel2.6

Parameters

MDRMEventObserver & aObserver	Observer.
const TDRMEventType & aEvent	the type of event to listen to
const TDesC8 & aContentID	the specific content id to listen to