1 /*

     2 * Copyright (c) 2006 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:   Catalogs Engine callback interface definition

    15 *

    16 */

    17 	

    18 

    19 #ifndef M_CATALOGS_ENGINE_OBSERVER_H

    20 #define M_CATALOGS_ENGINE_OBSERVER_H

    21 

    22 #include <e32cmn.h>

    23 

    24 /**

    25  * Observer interface for catalogs engine events

    26  *

    27  * Engine users should implement this interface to be able to receive

    28  * notifications from the catalogs engine

    29  *

    30  * 

    31  */

    32 class MCatalogsEngineObserver

    33     {

    34     

    35 public:

    36 

    37     /**

    38      * Called when the Catalogs Engine is about to be updated. The client

    39      * must stop using the Engine, closing its session(s) and deleting its

    40      * Catalogs Engine objects ASAP.

    41      */

    42     virtual void CatalogsEngineShutdown() = 0;

    43 

    44     /**

    45      * Called when a Catalogs OTA update is available. Only the client

    46      * authorized for Catalogs OTA updates will receive this callback.

    47      *

    48      * @param aTarget Update target.

    49      * @param aId Additional update target id, such as application UID or

    50      *  skin ID.

    51      * @param aVersion Update version.

    52      * @param aUri Uri for downloading the update package.

    53      * @param aForce ETrue if the update should be forced (user is not

    54      *  asked), EFalse otherwise.

    55      */

    56     virtual void CatalogsUpdateNotification( 

    57         const TDesC& aTarget,

    58         const TDesC& aId,

    59         const TDesC& aVersion,

    60     	const TDesC& aUri,

    61         TBool aForce ) = 0;

    62 

    63     /**

    64      * Called when connection status changes. This is called when client-

    65      * related network activity starts and stops.

    66      * 

    67      * @param aConnectionActive Connection status. ETrue if connection is active,

    68      * EFalse otherwise.

    69      */

    70     virtual void CatalogsConnectionEvent( TBool aConnectionActive ) = 0;

    71     };

    72     

    73 #endif //  M_CATALOGS_ENGINE_OBSERVER_H