/*

* Copyright (c) 2007 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:  Implementation class header of MDrmErrorHandling API

*

*/

#ifndef C_CDRMUIERRORHANDLING_H

#define C_CDRMUIERRORHANDLING_H

#include <e32base.h>

#include <f32file.h>

#include <caf/caftypes.h>

#include <drmerrorhandling.h>

namespace DRM

{

    //*** forward declarations go here:

    class CDrmUiHandlingImpl;

    class MDrmHandleErrorObserver;

/**

 *  Implementation class for the MDrmErrorHandling interface

 *  For DRM UI Handling

 *

 *  @lib drmuihandling.lib

 *  @since S60 v5.0

 */

NONSHARABLE_CLASS( CDrmUiErrorHandling ) :

    public CBase, public MDrmErrorHandling

    {

public:

    /**

     * Two-phased constructor.

     * @param aImplementation pointer to the implementation class

     */

    IMPORT_C static CDrmUiErrorHandling* NewL(

        CDrmUiHandlingImpl* aImplementation );

    /**

     * Two-phased constructor. Leaves the created object into the

     * cleanup stack

     * @param aImplementation pointer to the implementation class

     */

    IMPORT_C static CDrmUiErrorHandling* NewLC(

        CDrmUiHandlingImpl* aImplementation );

    /**

    * Destructor.

    */

    virtual ~CDrmUiErrorHandling();

public: // from base class MDrmErrorHandling

    /**

     * From MDrmErrorHandling

     *

     * Handles DRM error situations related to invalid rights.

     * This method displays appropriate notes, which observer can override, 

     * to the user and acquires new rights if needed. Asynchronous version,

     * all errors are signalled using request status. 

     *

     * @since S60 v5.0

     * @param[in]   aFile       file for which the error happened

     * @param[in]   aIntent     the CAF intent which was used to recieve 

     *                          the error

     * @param[in]   aError      error code

     * @param[in]   aObserver   reference to observer

     *

     * @return Operation Identifier for the async request

     *         required for cancelling an operation and

     *         identifying which request has been completed

     *

     * @see MDrmHandleErrorObserver

     * @see ContentAccess::TIntent

     */

        RFile& aFile,

        ContentAccess::TIntent aIntent, 

        TInt aError, 

        MDrmHandleErrorObserver& aObserver );

    /**

     * From MDrmErrorHandling

     *

     * Handles DRM error situations related to invalid rights.

     * This method displays appropriate notes, which observer can override, 

     * to the user and acquires new rights if needed. Synchronous version,

     * leaves in case of error. 

     *

     * @since S60 v5.0

     * @param[in]   aFile       file for which the error happened

     * @param[in]   aIntent     the CAF intent which was used to recieve 

     *                          the error

     * @param[in]   aError      error code

     * @param[in]   aObserver   pointer to observer, NULL if no observer

     *

     * @leave   KErrArgument    File is not DRM protected.

     *

     * @see MDrmHandleErrorObserver

     * @see ContentAccess::TIntent

     */

        RFile& aFile,

        ContentAccess::TIntent aIntent,              

        TInt aError, 

        MDrmHandleErrorObserver* aObserver );

    /**

     * From MDrmErrorHandling

     *

     * Handles DRM error situations related to invalid rights.

     * This method displays appropriate notes, which observer can override, 

     * to the user and acquires new rights if needed. Asynchronous version,

     * all errors are signalled using request status. 

     *

     * @since S60 v5.0

     * @param[in]   aFile       content for which the error happened

     * @param[in]   aIntent     the CAF intent which was used to recieve 

     *                          the error         

     * @param[in]   aError      error code

     * @param[in]   aObserver   reference to observer

     *

     * @return Operation Identifier for the async request

     *         required for cancelling an operation and

     *         identifying which request has been completed

     *

     * @see MDrmHandleErrorObserver

     * @see ContentAccess::TIntent

     */

        ContentAccess::CData& aFile,

        ContentAccess::TIntent aIntent,

        TInt aError, 

        MDrmHandleErrorObserver& aObserver );

    /**

     * From MDrmErrorHandling

     *

     * Handles DRM error situations related to invalid rights.

     * This method displays appropriate notes, which observer can override, 

     * to the user and acquires new rights if needed. Synchronous version,

     * leaves in case of error. 

     *

     * @since S60 v5.0

     * @param[in]   aFile       content for which the error happened

     * @param[in]   aIntent     the CAF intent which was used to recieve 

     *                          the error         

     * @param[in]   aError      error code

     * @param[in]   aObserver   pointer to observer, NULL if no observer

     *

     * @leave   KErrArgument    File is not DRM protected.

     *

     * @see MDrmHandleErrorObserver

     * @see ContentAccess::TIntent

     */

        ContentAccess::CData& aFile,

        ContentAccess::TIntent aIntent,

        TInt aError, 

        MDrmHandleErrorObserver* aObserver );

private:

    /**

    * C++ constructor

    */

    CDrmUiErrorHandling();

    /**

    * Second phase constructor

    */

    void ConstructL( CDrmUiHandlingImpl* aImplementation );

private: // data

    /**

     * Pointer to the implementation class

     * Not own.

     */

    CDrmUiHandlingImpl* iImplementation;

    };

}

#endif // C_CDRMUIERRORHANDLING_H