/*

* Copyright (c) 2002-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 communications between a notifier client & 

*                DRM server in DRM notifier.

*

*/

#ifndef RDRMNOTIFIERCLIENT_H

#define RDRMNOTIFIERCLIENT_H

//  INCLUDES

#include <E32STD.H>

#include <DRMEvent.h>

// CONSTANTS

const TInt KMaxMessageSlots = 2;

// MACROS

// DATA TYPES

// FUNCTION PROTOTYPES

// FORWARD DECLARATIONS

// CLASS DECLARATION

/**

*  This class handles all client/server communications.

*  

*  @lib DRMCommon.dll

*  @since S60Rel2.6

*/

class RDRMNotifierClient : public RSessionBase

    {

    public:  // Constructors and destructor

       /**

        * C++ default constructor.

        */

       RDRMNotifierClient(TDRMEventType* aEventType, TDRMEventType* aEventTypeWait, 

                          TPtr8* aPtr, TPtr8* aWaitPtr);

       /**

        * Destructor.

        */

       virtual ~RDRMNotifierClient();

    public: // New functions

       /**

       * This method opens a connection to the server.

       * @since S60Rel2.6

       * Return Symbian OS / DRM Engine specific error code.

       */

       TInt Connect( void );

       /**

       * WaitForCompletion

       *

       * Waits for notifications. When the status is completed a notification

       * has been received.

       *

       * @since S60Rel2.6

       * @param aStatus  the status will be updated when the a notification

       *                 has been received

       * @return none 

       */

       void WaitForCompletion( TRequestStatus& aStatus );

       /**

       * SendEvent

       *

       * Sends an event to the notifier server, the request status is updated

       * when all the notifications have been forwarded

       *

       * @since S60Rel2.6

       * @param aStatus  the status will be updated when all notifications have

       *                 been forwarded

       * @return none 

       */

       void SendEvent( TRequestStatus& aStatus );

       /**

       * RegisterForType

       *

       * Register to the server to listen to specific event types, if a URI

       * is provided notifications of the type that have that URI as affected

       * URI will get notified

       *

       * @since S60Rel2.6

       * @param aEventType  the event type to listen to

       * @param aURI  optional URI to limit the C/S communication

       * @return none 

       */

       void RegisterForType( TDRMEventType aEventType, HBufC8* aURI = 0 );

       /**

       * UnRegisterFromType

       *

       * Unregister from the server from listening to specific event types, 

       * if a URI is provided notifications of the type that have that URI 

       * as affected URI will get unregistered

       *

       * @since S60Rel2.6

       * @param aEventType  the event type to listen to

       * @param aURI  optional URI to limit the C/S communication

       * @return none 

       */

       void UnRegisterFromType( TDRMEventType aEventType, HBufC8* aURI = 0 );

       /**

       * CancelRequest()

       *

       * Used when the object is being destroyed. All calls are cancelled and

       * the server side will get a notification to remove all notifications

       * from their lists

       *

       * @since S60Rel2.6

       * @return none

       */

       void CancelRequest();

    public: // Functions from base classes

        void Close();      

    protected:  // New functions

    protected:  // Functions from base classes

    private:

        // Prohibit copy constructor

        RDRMNotifierClient( const RDRMNotifierClient& );

        // Prohibit assigment operator

        RDRMNotifierClient& operator=( const RDRMNotifierClient& );

    public:     // Data

    protected:  // Data

    private:    // Data

        TDRMEventType* iEventType;

        TDRMEventType* iEventTypeWait;

        TPtr8* iData;

        TPtr8* iWaitData;

        TPckg<TInt> numdata;

    public:     // Friend classes

    protected:  // Friend classes

    private:    // Friend classes

    };

#endif      // RDRMNOTIFIERCLIENT_H

// End of File