/*

 * Copyright (c) 2005 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:   Update agent result codes

 *

 */

#ifndef __COMMUNICATION_BETWEEN_NORMAL_AND_UPDATE_MODE_H__

#define __COMMUNICATION_BETWEEN_NORMAL_AND_UPDATE_MODE_H__

typedef enum

    {

    /*

     Everything is ok - update package were installed successfully and 

     newer version of OS is running.

     */

    UPD_OK = 0,

    /*

     Problem: The request sent to update installer were invalid - probable issue in

     Download agent.

     Solutions:

     - Probable: Download agent created an invalid file.

     Fix download agent.

     - Inprobable: Corrupted request file, or FAT

     */

    UPD_INSTALL_REQUEST_IS_INVALID = 1,

    /*

     Problem: Update package is absent from specified location.

     Solution: Incorrect user application actions. 

     Read update application document / manual on how to switch to 

     update mode.

     */

    UPD_UPDATE_PACKAGE_IS_ABSENT = 2,

    /*

     Problem: Update package is corrupted. (Integrity or authenticity 

     check failed)

     Solution: End-user should try to download again update package.

     */

    UPD_UPDATE_PACKAGE_IS_CORRUPTED = 3,

    /*

     Problem: Update package contents is invalid for some reason.

     This problem normally refers to the fact that update package

     were created incorrectly.

     Solution: Contact update package build team in order to find out the 

     error cause.

     */

    UPD_UPDATE_PACKAGE_CONTENTS_IS_INVALID = 4,

    /*

     Problem: Update package is not compatible with current mobile device.

     Solution: End-user should try to download again update package.

     */

    UPD_UPDATE_PACKAGE_IS_NOT_COMPATIBLE_WITH_CURRENT_MOBILE_DEVICE = 5,

    /*

     Problem: This error code will be used to indicate fatal error 

     code after which phone becomes dead.

     Solution: Phone should be taken to maintenance.

     This error code cannot be seen by normal mode applications 

     because OS cannot be started when phone became dead.

     */

    UPD_FATAL_ERROR = 0xFFFFFFFF

    } InstallationResult;

typedef enum

    {

    UPD_InvalidBlockHeaderIdentifier = 1,

    UPD_InvalidUpdatePackageVersion = 2,

    UPD_GenericInvalidFileFormat = 3

    } DetailedInstallationResult;

#endif //__COMMUNICATION_BETWEEN_NORMAL_AND_UPDATE_MODE_H__