/*

* 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:

*  wmdrmotaaccess.h

*

*/

#ifndef _WMDRM_OTA_ACCESS_API_H_

#define _WMDRM_OTA_ACCESS_API_H_

// Forward declarations

class CWmDrmOtaAccessEcomInterface;

// Class declaration

/**

*  Provides access to WM DRM Over-the-Air

*  Functionality

*

*  @code

*

*  CWmDrmOtaAccess* access( CWmDrmOtaAccess::NewL() );

*  delete access;

*  @endcode

*

*/

NONSHARABLE_CLASS( CWmDrmOtaAccess ) : public CBase

    {     

public:

    /** Constructors */

    IMPORT_C static CWmDrmOtaAccess* NewL();

    IMPORT_C static CWmDrmOtaAccess* NewLC();

    /** Destructor */

    IMPORT_C virtual ~CWmDrmOtaAccess();

    /**

    *  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      

    */

    IMPORT_C void GetLicenseChallengeL( const TDesC8& aDrmHeader, 

                                        HBufC8*& aChallenge );

    /**

    *  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      

    */

    IMPORT_C void GetLicenseChallengeL( const TDesC8& aDrmHeader, 

                                        HBufC8*& aChallenge, 

                                        TRequestStatus& aStatus );

    /**

    *  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        

    */

    IMPORT_C void HandleLicenseResponseL( const TDesC8& aResponse );

    /**

    *  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      

    */

    IMPORT_C void HandleLicenseResponseL( const TDesC8& aResponse, 

                                          TRequestStatus& aStatus );

private:

    /** Default constructor */

    CWmDrmOtaAccess();

    /** Second phase constructor */

    void ConstructL();

    /** Internal interface to the WM DRM system */

    CWmDrmOtaAccessEcomInterface* iWmDrmOtaAccessEcomInterface;

    };

#endif // _WMDRM_OTA_ACCESS_API_H_