1 /*

     2 * Copyright (c) 2009 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:   MIAUpdateHistoryItem

    15 *

    16 */

    17 

    18 

    19 

    20 #ifndef IA_UPDATE_HISTORY_ITEM_H

    21 #define IA_UPDATE_HISTORY_ITEM_H

    22 

    23 #include <e32std.h>

    24 #include <e32cmn.h>

    25 

    26 /**

    27  * MIAUpdateHistory interface provides history item.

    28  *

    29  * @since S60 v3.2

    30  */

    31 class MIAUpdateHistoryItem

    32     {

    33 

    34 public: 

    35 

    36     /**

    37      * TIAHistoryItemState

    38      * Describes what operations has been completed

    39      * to the history item.

    40      * The state information can be used together with the

    41      * information about the last error code, to decide what operations

    42      * have been completed succesfully.

    43      */

    44     enum TIAHistoryItemState

    45         {

    46         /**

    47          * Nothing has been done to the item.

    48          * This should never be the case, because item is in

    49          * purchase history only after the purchase has been succefully

    50          * finished.

    51          */

    52         EUnknownState,

    53         

    54         /**

    55          * Item has been purchased successfully, but not downlaoded yet.

    56          */

    57         EPurchased,

    58         

    59         /**

    60          * Item has been downloaded succesfully, but not installed yet.

    61          */

    62         EDownloaded,

    63         

    64         /**

    65          * Item has been installed succesfully. So, the whole process has been

    66          * completed.

    67          */          

    68         EInstalled

    69         };

    70 

    71 

    72     /**

    73      * Destructor

    74      *

    75      * @since S60 v3.2

    76      */

    77     virtual ~MIAUpdateHistoryItem() { }

    78 

    79 

    80     /**

    81      * @return

    82      *

    83      * @since S60 v3.2

    84      */

    85     virtual const TDesC& Name() const = 0;

    86     

    87     /**

    88      * @return

    89      *

    90      * @since S60 v3.2

    91      */

    92     virtual const TDesC& Version() const = 0;

    93 

    94     /**

    95      * @return

    96      *

    97      * @since S60 v3.2

    98      */

    99     virtual TTime LastOperationTime() const = 0;

   100 

   101     /**

   102      * @return 

   103      *

   104      * @since S60 v3.2

   105      */

   106     virtual TInt LastOperationErrorCode() const = 0;

   107 

   108     /**

   109      * The state information can be used together with the

   110      * information about the last error code, to decide what operations

   111      * have been completed succesfully.

   112      *

   113      * @return 

   114      *

   115      * @since S60 v3.2

   116      */

   117     virtual TIAHistoryItemState StateL() const = 0;

   118 

   119     };

   120 

   121 #endif // IA_UPDATE_HISTORY_ITEM_H