1 /*

     2 * Copyright (c) 2004-2008 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 the License "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:    IAD update handling.*

    15 */

    16 

    17 

    18 

    19 

    20 #ifndef CVCXVIADUPDATE_H

    21 #define CVCXVIADUPDATE_H

    22 

    23 // INCLUDES

    24 #include <e32std.h>

    25 #include "CIptvUtil.h"

    26 #include <iaupdateobserver.h>

    27 

    28 // CONSTANTS

    29 // None

    30 

    31 // FORWARD DECLARATIONS

    32 class CIAUpdate;

    33 class CIAUpdateParameters;

    34 

    35 // CLASS DECLARATION

    36 

    37 /**

    38  *  Category info describtor.

    39  *

    40  *  @lib IptvUtil..lib

    41  *  @since Engine 4.0

    42  */

    43 class CVcxIadUpdate : public CBase, public MIAUpdateObserver

    44     {

    45 

    46 public: // Constructors and destructor

    47 

    48     /**

    49      * Two-phased constructor.

    50      */

    51     IMPORT_C static CVcxIadUpdate* NewL();

    52 

    53     /**

    54      * Destructor.

    55      */

    56     virtual ~CVcxIadUpdate();

    57    

    58 public: // New methods

    59 

    60     /**

    61      * Start IAD update process.

    62      */

    63     void StartL();

    64 

    65 private: // Constructors and destructor

    66 

    67     /**

    68      * C++ default constructor.

    69      */

    70     CVcxIadUpdate();

    71 

    72     /**

    73     * By default Symbian 2nd phase constructor is private.

    74     */

    75     void ConstructL();

    76     

    77 private: // New methods

    78 

    79 

    80     /** 

    81      * From MIAUpdateObserver.

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

    83      *

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

    85      *                   KErrNone for successful completion, 

    86      *                   otherwise a system wide error code.

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

    88      *

    89      * @since S60 v3.2

    90      */

    91     void CheckUpdatesComplete( TInt aErrorCode, TInt aAvailableUpdates );

    92 

    93 

    94     /** 

    95      * From MIAUpdateObserver.

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

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

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

    99      *

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

   101      *                   KErrNone for successful completion, 

   102      *                   otherwise a system wide error code.

   103      * @param aResult Details about the completed update operation.

   104      *                Ownership is transferred.

   105      *

   106      * @since S60 v3.2

   107      */

   108     void UpdateComplete( TInt aErrorCode, CIAUpdateResult* aResultDetails );

   109 

   110 

   111     /** 

   112      * From MIAUpdateObserver.

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

   114      *

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

   116      *                   KErrNone for successful completion, 

   117      *                   otherwise a system wide error code.

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

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

   120      *                   operation.

   121      * @since Series 60 3.2

   122      */

   123     void UpdateQueryComplete( TInt aErrorCode, TBool aUpdateNow );

   124 

   125 

   126     /**

   127      * Parses SDP file.

   128      * @since Series 60 3.2

   129      * @param none.

   130      * @return none.

   131      */

   132     void Delete();

   133 

   134 public: // Data

   135 

   136 

   137     /**

   138      * IAD update API.

   139      */

   140     CIAUpdate* iUpdate;

   141 

   142     /**

   143      * IAD update parameters.

   144      */

   145     CIAUpdateParameters* iParameters;

   146 

   147 

   148     };

   149 

   150 #endif // CVCXVIADUPDATE_H

   151 

   152 //  End of File