/*

* Copyright (c) 2010 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:

*  wmdrmotaaccessecominterface.h

*

*/

#ifndef _WMDRMOTAACCESSECOMINTERFACE_H_

#define _WMDRMOTAACCESSECOMINTERFACE_H_

#include <e32base.h>

// Class declaration

NONSHARABLE_CLASS( CWmDrmOtaAccessEcomInterface ) : public CBase

    {

public:

    // Constructors

    static CWmDrmOtaAccessEcomInterface* NewL();

    static CWmDrmOtaAccessEcomInterface* NewLC();

    // Destructor

    virtual ~CWmDrmOtaAccessEcomInterface();

    /**

    *  GetLicenseChallengeL

    *  Syncronous method

    *

    *  Get the license challenge that can be sent to the server to fetch

    *  a license

    *

    *  @param   aDrmHeader  IN  The drm header

    *  @param   aChallenge  OUT Resulting Challenge

    *  @return  None

    *  @leave   Symbian OS error codes      

    */

    virtual void GetLicenseChallengeL( const TDesC8& aDrmHeader, 

                               HBufC8*& aChallenge ) = 0;

    /**

    *  GetLicenseChallengeL

    *  Asyncronous method

    *

    *  Get the license challenge that can be sent to the server to fetch

    *  a license    

    *

    *  @param   aDrmHeader  IN  The drm header

    *  @param   aChallenge  OUT Resulting Challenge

    *  @param   aStatus     OUT Asyncronous request status

    *  @return  None

    *  @leave   Symbian OS error codes      

    */

    virtual void GetLicenseChallengeL( const TDesC8& aDrmHeader, 

                                       HBufC8*& aChallenge, 

                                       TRequestStatus& aStatus ) = 0;

    /**

    *  HandleLicenseResponseL

    *  Syncronous method

    *

    *  Handle the response received from the server in correspondence

    *  to the license challenge

    *

    *  @param   aResponse   IN  The license response

    *  @return  None

    *  @leave   Symbian OS error codes        

    */

    virtual void HandleLicenseResponseL( const TDesC8& aResponse ) = 0;

    /**

    *  GetLicenseChallengeL

    *  Asyncronous method

    *

    *  Handle the response received from the server in correspondence

    *  to the license challenge

    *    

    *  @param   aResponse   IN  The license response

    *  @param   aStatus     OUT Asyncronous request status    

    *  @return  None

    *  @leave   Symbian OS error codes      

    */

    virtual void HandleLicenseResponseL( const TDesC8& aResponse, 

                                         TRequestStatus& aStatus ) = 0;

private:

    // internal variable used on freeing ecom related resources

    TUid iDtor_ID_Key;

    };

#include "wmdrmotaaccessecominterface.inl"

#endif _WMDRMOTAACCESSECOMINTERFACE_H_