/*

* Copyright (c) 2004-2008 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of the License "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:    IAD update handling.*

*/

#ifndef CVCXVIADUPDATE_H

#define CVCXVIADUPDATE_H

// INCLUDES

#include <e32std.h>

#include "CIptvUtil.h"

#include <iaupdateobserver.h>

// CONSTANTS

// None

// FORWARD DECLARATIONS

class CIAUpdate;

class CIAUpdateParameters;

// CLASS DECLARATION

/**

 *  Category info describtor.

 *

 *  @lib IptvUtil..lib

 *  @since Engine 4.0

 */

class CVcxIadUpdate : public CBase, public MIAUpdateObserver

    {

public: // Constructors and destructor

    /**

     * Two-phased constructor.

     */

    IMPORT_C static CVcxIadUpdate* NewL();

    /**

     * Destructor.

     */

    virtual ~CVcxIadUpdate();

public: // New methods

    /**

     * Start IAD update process.

     */

    void StartL();

private: // Constructors and destructor

    /**

     * C++ default constructor.

     */

    CVcxIadUpdate();

    /**

    * By default Symbian 2nd phase constructor is private.

    */

    void ConstructL();

private: // New methods

    /** 

     * From MIAUpdateObserver.

     * This callback function is called when the update checking operation has completed.

     *

     * @param aErrorCode The error code of the observed update operation.

     *                   KErrNone for successful completion, 

     *                   otherwise a system wide error code.

     * @param aAvailableUpdates Number of the updates that were found available.

     *

     * @since S60 v3.2

     */

    void CheckUpdatesComplete( TInt aErrorCode, TInt aAvailableUpdates );

    /** 

     * From MIAUpdateObserver.

     * This callback function is called when an update operation has completed.

     * Even if multiple functions are provided to start different update operations,

     * this callback function is always called after an update operation has completed.

     *

     * @param aErrorCode The error code of the completed update operation.

     *                   KErrNone for successful completion, 

     *                   otherwise a system wide error code.

     * @param aResult Details about the completed update operation.

     *                Ownership is transferred.

     *

     * @since S60 v3.2

     */

    void UpdateComplete( TInt aErrorCode, CIAUpdateResult* aResultDetails );

    /** 

     * From MIAUpdateObserver.

     * This callback function is called when an update query operation has completed.

     *

     * @param aErrorCode The error code of the observed query operation.

     *                   KErrNone for successful completion, 

     *                   otherwise a system wide error code.

     * @param aUpdateNow ETrue informs that an update operation should be started.

     *                   EFalse informs that there is no need to start an update

     *                   operation.

     * @since Series 60 3.2

     */

    void UpdateQueryComplete( TInt aErrorCode, TBool aUpdateNow );

    /**

     * Parses SDP file.

     * @since Series 60 3.2

     * @param none.

     * @return none.

     */

    void Delete();

public: // Data

    /**

     * IAD update API.

     */

    CIAUpdate* iUpdate;

    /**

     * IAD update parameters.

     */

    CIAUpdateParameters* iParameters;

    };

#endif // CVCXVIADUPDATE_H

//  End of File