Swi::MInstallerUiHandler Class Reference

class Swi::MInstallerUiHandler

This represents the User Interface handler for the installation of SISX files by Software Install Server.

Member Functions Documentation

DisplayCannotOverwriteFileL(const CAppInfo &, const CAppInfo &, const TDesC &)

voidDisplayCannotOverwriteFileL(const CAppInfo &aAppInfo,
const CAppInfo &aInstalledAppInfo,
const TDesC &aFileName
)[pure virtual]

Used to inform the user the installation they are attempting is trying to overwrite a file that does not belong to it. Following this message installation is aborted.

Parameters

const CAppInfo & aAppInfoInformation about the application.
const CAppInfo & aInstalledAppInfoInformation about the application that owns the file in question.
const TDesC & aFileNameThe filename of the file in question

DisplayDriveL(const CAppInfo &, TInt64, const RArray< TChar > &, const RArray< TInt64 > &)

TInt DisplayDriveL(const CAppInfo &aAppInfo,
TInt64aSize,
const RArray< TChar > &aDriveLetters,
const RArray< TInt64 > &aDriveSpaces
)[pure virtual]

Requests the drive to install the package on, from the UI.

Parameters

const CAppInfo & aAppInfoInformation about the application.
TInt64 aSizeTotal size of the files that will be installed on the configurable drive.
const RArray< TChar > & aDriveLettersArray of drive letters on which the package can be installed.
const RArray< TInt64 > & aDriveSpacesArray of space free (in bytes) on each of the drives in the aDriveLetters array.

DisplayGrantCapabilitiesL(const CAppInfo &, const TCapabilitySet &)

TBool DisplayGrantCapabilitiesL(const CAppInfo &aAppInfo,
const TCapabilitySet &aCapabilitySet
)[pure virtual]

Displays a dialog requesting that the user grants these capabilities to the SISX package being installed. This dialog must be shown in TrustedUI mode.

Note:

Trusted UI

Parameters

const CAppInfo & aAppInfoInformation about the application.
const TCapabilitySet & aCapabilitySetThe capabilities requested by the SISX package.

DisplayInstallL(const CAppInfo &, const CApaMaskedBitmap *, const RPointerArray< CCertificateInfo > &)

TBool DisplayInstallL(const CAppInfo &aAppInfo,
const CApaMaskedBitmap *aLogo,
const RPointerArray< CCertificateInfo > &aCertificates
)[pure virtual]

Displays a dialog at the beginning of an installation with details about the SISX package being installed. This dialog must be shown in TrustedUI mode.

An installer UI should call REComSession::FinalClose() as part of clean up.

Note:

Trusted UI

Parameters

const CAppInfo & aAppInfoInformation about the application.
const CApaMaskedBitmap * aLogoThe logo data in the SISX file. If no logo is present it will be NULL.
const RPointerArray< CCertificateInfo > & aCertificatesAn array of end entity certificates, one for each chain in the SISX file. If the SISX file is unsigned this array will have zero length.

DisplayLanguageL(const CAppInfo &, const RArray< TLanguage > &)

TInt DisplayLanguageL(const CAppInfo &aAppInfo,
const RArray< TLanguage > &aLanguages
)[pure virtual]

Requests preferred language and dialect information from the UI.

Parameters

const CAppInfo & aAppInfoInformation about the application.
const RArray< TLanguage > & aLanguagesArray of languages supported by the SIS file.

DisplayMissingDependencyL(const CAppInfo &, const TDesC &, TVersion, TVersion, TVersion)

TBool DisplayMissingDependencyL(const CAppInfo &aAppInfo,
const TDesC &aDependencyName,
TVersionaWantedVersionFrom,
TVersionaWantedVersionTo,
TVersionaInstalledVersion
)[pure virtual]

Used to inform the user of a missing dependency needed to install the current package. It is up to the UI implementors and/or the user whether or not this warning can be overridden.

Parameters

const CAppInfo & aAppInfoInfo about the current application.
const TDesC & aDependencyNameName of the missing dependency.
TVersion aWantedVersionFromEnding suitable version number of the mising dependency. Can be all zeros, meaning it is unknown.
TVersion aWantedVersionTo
TVersion aInstalledVersionThe installed (unsuitable) version of the missing dependency. Can be all zeros, meaning the missing dependency is not installed.

DisplayOcspResultL(const CAppInfo &, TRevocationDialogMessage, RPointerArray< TOCSPOutcome > &, RPointerArray< CCertificateInfo > &, TBool)

TBool DisplayOcspResultL(const CAppInfo &aAppInfo,
TRevocationDialogMessageaMessage,
RPointerArray< TOCSPOutcome > &aOutcomes,
RPointerArray< CCertificateInfo > &aCertificates,
TBoolaWarningOnly
)[pure virtual]

Displays a dialog indicating that there was an error carrying out online certificate status checking.

Parameters

const CAppInfo & aAppInfoApplication info from the package file
TRevocationDialogMessage aMessageThe error which occurred during online certificate status checking
RPointerArray< TOCSPOutcome > & aOutcomesThe outcomes of the OCSP checks
RPointerArray< CCertificateInfo > & aCertificatesCertificate information of the end (signing) certificates that correspond to the outcomes
TBool aWarningOnlyETrue if the installation is allowed to continue after a warning, EFalse otherwise.

DisplayOptionsL(const CAppInfo &, const RPointerArray< TDesC > &, RArray< TBool > &)

TBool DisplayOptionsL(const CAppInfo &aAppInfo,
const RPointerArray< TDesC > &aOptions,
RArray< TBool > &aSelections
)[pure virtual]

Displays a dialog box asking which options the user wishes to install.

Parameters

const CAppInfo & aAppInfoInformation about the application.
const RPointerArray< TDesC > & aOptionsAn array of option names.
RArray< TBool > & aSelectionsAn array of booleans, corresponding to the aOptions array.

DisplaySecurityWarningL(const CAppInfo &, TSignatureValidationResult, RPointerArray< CPKIXValidationResultBase > &, RPointerArray< CCertificateInfo > &, TBool)

TBool DisplaySecurityWarningL(const CAppInfo &aAppInfo,
TSignatureValidationResultaSigValidationResult,
RPointerArray< CPKIXValidationResultBase > &aPkixResults,
RPointerArray< CCertificateInfo > &aCertificates,
TBoolaInstallAnyway
)[pure virtual]

Displays a dialog indicating that the package is unsigned, or that signature validation has failed.

Parameters

const CAppInfo & aAppInfoInformation about the application.
TSignatureValidationResult aSigValidationResultThe result of signature validation.
RPointerArray< CPKIXValidationResultBase > & aPkixResultsResults of a validation of the PKIX certificate chains
RPointerArray< CCertificateInfo > & aCertificatesCertificate information for the failed end (signing) certificates
TBool aInstallAnywayETrue if installation is allowed to continue.

DisplayUpgradeL(const CAppInfo &, const CAppInfo &)

TBool DisplayUpgradeL(const CAppInfo &aAppInfo,
const CAppInfo &aExistingAppInfo
)[pure virtual]

Displays a dialog asking whether we want to upgrade an application present on the device.

Parameters

const CAppInfo & aAppInfoInformation about the application being installed.
const CAppInfo & aExistingAppInfoInformation about the existing application.

HandleCancellableInstallEventL(const CAppInfo &, TInstallCancellableEvent, MCancelHandler &, TInt, const TDesC &)

voidHandleCancellableInstallEventL(const CAppInfo &aAppInfo,
TInstallCancellableEventaEvent,
MCancelHandler &aCancelHandler,
TIntaValue = 0,
const TDesC &aDes =  KNullDesC
)[pure virtual]

Informs the UI of cancellable events occurring during installation.

Parameters

const CAppInfo & aAppInfoInformation about the application.
TInstallCancellableEvent aEventThe event which has occurred.
MCancelHandler & aCancelHandlerThis mix-in is used to inform Software Install that the user has pressed the cancel button on the dialog.
TInt aValue = 0The value associated with the event if applicable.
const TDesC & aDes =  KNullDesC A descriptor associated with the event if applicable.

HandleInstallEventL(const CAppInfo &, TInstallEvent, TInt, const TDesC &)

TBool HandleInstallEventL(const CAppInfo &aAppInfo,
TInstallEventaEvent,
TIntaValue = 0,
const TDesC &aDes =  KNullDesC
)[pure virtual]

Informs the UI of events occurring during installation.

Parameters

const CAppInfo & aAppInfoInformation about the application.
TInstallEvent aEventThe event which has occurred.
TInt aValue = 0The value associated with the event if applicable.
const TDesC & aDes =  KNullDesC A descriptor associated with the event if applicable.