/*

* 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:  Backup and restore events listener.

 *

*/

#ifndef C_CPSERVERBURLISTENER_H

#define C_CPSERVERBURLISTENER_H

#include <e32base.h>

#include <e32property.h>

/**

 *  Interface for observing Backup and Restore events.

 *

 *  @since S60 S60 v3.1

 */

class MBURListenerCallback

    {

public:

    /**

     * Enum defining the status of Backup and Restore.

     */

    enum TBURStatus

        {

        EBURStatusNone,

        EBURStatusBackup,

        EBURStatusRestore

        };

    /**

     * HandleBUREventL is called when Backup and Restore state has been changed.

     * @param aStatus Current Backup and Restore status.

     */

    virtual void HandleBUREventL( TBURStatus aStatus ) = 0;

    };

/**

 *  Central Repository observer for Backup and Restore.

 *

 *  @since S60 S60 v3.1

 */

NONSHARABLE_CLASS(CCPServerBURListener) : public CActive

    {

public:

    /**

     * Creates an instance of CCPServerBURListener implementation.

     * @param aCallBack Pointer to observer interface.

     */

    static CCPServerBURListener* NewL( MBURListenerCallback* aCallback );

    /**

     * Destructor.

     */

    virtual ~CCPServerBURListener();

    /**

     * @return EFalse if the device as a whole is not engaged in a backup or restore .

     */

    TBool CheckBUR();

private:

    /**

     * Constructor.

     * @param aCallBack Pointer to observer interface.

     */

    CCPServerBURListener( MBURListenerCallback* aCallback );

    /**

     * Symbian 2nd phase constructor.

     */

    void ConstructL();

    /**

     * From CActive.

     */

    void DoCancel();

    /**

     * From CActive.

     */

    void RunL();

    /**

     * From CActive.

     */

    TInt RunError( TInt aError );

private:

    /**

     * User side interface to Publish & Subscribe.

     */

    RProperty iProperty;

    /**

     * Interface for notifying changes in Backup and Restore.

     * Not own.

     */

    MBURListenerCallback* iCallback;

    };

#endif // C_CPSERVERBURLISTENER_H

// End of File