/*

* Copyright (c) 2004-2006 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:  This class handles registering and unregistering of

*                DRM event observers to DRM notifier, and sending

*                DRM notifications to other registered observers.

*

*/

#ifndef CDRMNOTIFIER_H

#define CDRMNOTIFIER_H

//  INCLUDES

#include <e32base.h>

#include <DRMEventObserver.h>

#include <DRMEvent.h>

// CONSTANTS

// MACROS

// DATA TYPES

// FUNCTION PROTOTYPES

// FORWARD DECLARATIONS

class CDRMEventHandler;

// CLASS DECLARATION

/**

 *  With this class an application can register to receive DRM related 

 *  notifications.

 *

 *  @lib DRMCommon.dll

 *  @since S60Rel2.6

 */

class CDRMNotifier : public CBase

{

public:  // Constructors and destructor   

    /**

    * Two-phased constructor.

    */

    IMPORT_C static CDRMNotifier* NewL( void );

    /**

    * Two-phased constructor.

    */

    IMPORT_C static CDRMNotifier* NewLC( void );

    /**

    * Destructor.

    */

    IMPORT_C virtual ~CDRMNotifier();

public: // New functions   

    /**

    * RegisterEventObserverL

    *

    * Registers a new event observer to DRM Notifier. Listens to all events

    * of the given type

    *

    * @since S60Rel2.6

    * @param aObserver Observer.

    * @param aEvent the type of event to listen to

    * @return none, leaves with Symbian OS error code if an error occurs

    */

    IMPORT_C void RegisterEventObserverL( MDRMEventObserver& aObserver , 

                                          const TDRMEventType& aEvent);   

    /**

    * UnRegisterEventObserverL

    *

    * Unregisters existing event observer from DRM Notifier.

    *

    * @since S60Rel2.6

    * @param aObserver Observer.

    * @param aEvent the type of event to unregister

    * @return none, leaves with Symbian OS error code if an error occurs

    */

    IMPORT_C void UnRegisterEventObserverL( MDRMEventObserver& aObserver, 

                                            const TDRMEventType& aEvent);

    /**

    * 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

    * @param aObserver Observer

    * @param aEvent the type of event to listen to

    * @param aContentID the specific content id to listen to

    * @return none, leaves with Symbian OS error code if an error occurs

    */

    IMPORT_C void RegisterEventObserverL( MDRMEventObserver& aObserver , 

                                          const TDRMEventType& aEvent,

                                          const TDesC8& aContentID);

    /**

    * UnRegisterEventObserverL

    *

    * Unregisters existing event observer from DRM Notifier.

    *

    * @since S60Rel2.6

    * @param aObserver Observer.

    * @param aEvent the type of event to listen to

    * @param aContentID the specific content id to listen to

    * @return none, leaves with Symbian OS error code if an error occurs

    */

    IMPORT_C void UnRegisterEventObserverL( MDRMEventObserver& aObserver, 

                                            const TDRMEventType& aEvent,

                                            const TDesC8& aContentID);

    /**

    * SendEventL

    *

    * Sends a notification to registered observers

    *

    * @since S60Rel2.6

    * @param aEvent  the event to be sent

    * @param aStatus  the request status for the event, will be updated when

    *                 the event has been sent

    * @return none

    */

    IMPORT_C void SendEventL( MDRMEvent& aEvent, TRequestStatus& aStatus ); 

private:

    /**

    * C++ default constructor.

    */

    CDRMNotifier( void );

    /**

    * First Phase constructor

    */

    void ConstructL();

    // Prohibit copy constructor if not deriving from CBase.

    CDRMNotifier( const CDRMNotifier& );

    // Prohibit assigment operator if not deriving from CBase.

    CDRMNotifier& operator=( const CDRMNotifier& );

  private:    // Data

   // Event handler.

   CDRMEventHandler* iEventHandler;

};

#endif      // CDRMNOTIFIER_H   

// End of File