/*

* 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:  Service api which exposes some of the private functionality

*                as a domain API

*

*/

#ifndef C_CDRMSERVICEAPI_H

#define C_CDRMSERVICEAPI_H

#include <e32base.h>

// Forward declarations

class RDRMClockClient;

namespace Roap

    {

    class RRoapStorageClient;   

    }

namespace DRM 

    {

/**

 *  Drm Service Api which provides access to some drm private functionality

 *

 *  @lib DrmServiceAPI.lib

 *  @since S60 v3.2

 */

NONSHARABLE_CLASS( CDrmServiceApi ) : public CBase

    {

public:

    /**

     * Two-phased constructor

     *

     * Creates a function CDrmServiceApi -object and returns a pointer to it

     * pointer is owned by the caller

     *

     * @since   S60 v3.2

     * @return  Symbian OS error code if any.

     */

    IMPORT_C static CDrmServiceApi* NewL();

    /**

     * Two-phased constructor

     *

     * Creates a function CDrmServiceApi -object and returns a pointer to it

     * pointer is owned by the caller, the pointer is left to the cleanup stack

     *

     * @since   S60 v3.2

     * @return  Symbian OS error code if any.

     */

    IMPORT_C static CDrmServiceApi* NewLC();

    /**

    * Destructor.

    */

    virtual ~CDrmServiceApi();

    /**

     * Get the secure time

     *

     * @since   S60 v3.2

     * @param   aTime           Output parameter containing the 

     *                          secure time in UTC.

     * @param   aTimeZone       Time zone information including summer/winter time

     *                          in +/- 15 minutes

     * @param   aSecurityLevel  Output parameter Securiry level.

     * @return  Symbian OS error code if any.

     */

    IMPORT_C TInt GetSecureTime( TTime& aTime, 

                                 TInt& aTimeZone,

                                 DRMClock::ESecurityLevel& aSecurityLevel ) const;

    /**

     * Update the secure time

     *

     * Requires DRM Capability

     *

     * @since   S60 v3.2

     * @param   aTime           Input parameter containing the 

     *                          secure time in UTC.

     * @param   aTimeZone       Time zone information including 

     *                          summer/winter time

     *                          in +/- 15 minutes         

     * @return  Symbian OS error code if any.

     */

    IMPORT_C TInt UpdateSecureTime( const TTime& aTime, const TInt& aTimeZone );

    /**

     * Get the device public key in Der format

     *

     * @since   S60 v3.2

     * @param   aPublicKey      Return parameter for the public key owned by

     *                          the caller

     * @return  none

     * @leave Symbian OS error code

     */

    IMPORT_C void GetDevicePublicKeyDerL( HBufC8*& aPublicKey );

    /**

     * Sign the value given

     *

     * @since   S60 v3.2

     * @param   aHash           Value to be signed

     * @param   aSignature      Return parameter for the signature, owned by

     *                          the caller

     * @return  none

     * @leave Symbian OS error code

     */

    IMPORT_C void SignL( const TDesC8& aHash, HBufC8*& aSignature );

private:

    /**

    * Default constructor

    */

    CDrmServiceApi();

    /**

    * 2nd phase constructor

    */

    void ConstructL();

private: // data

    /**

    * Owned clock client

    */

    RDRMClockClient* iClockClient;

    /**

    * Owned roap storage client

    */

    Roap::RRoapStorageClient* iRoapStorageClient;

    };

    }

#endif // C_CDRMSERVICEAPI_H