Collapse all Symbian^3 Product Developer Library

ChspsInstallationHandler Class Reference

class ChspsInstallationHandler : public CBase

Class ChspsInstallationHandler. ChspsInstallationHandler performs all theme installation related functionality for hspsThemeServer.

Class inheritance: ================== ChspsInstallationHandler implements MhspsInstallationService from HSPS Theme Management Service and MContentHandler for XML-parsing of manifest file. For more information, see the architecture description in the beginning of this file.

Functionality: ============== ChspsInstallationHandler offer high- and low-level API-functionality. High-level and low-level calls are diffrentiated by their parametrization. High-level parametrization is directed to the be used by applications which need human readable data and offer a user interface. Low-level parametrization is directed to the machine-originated requestors like OTA Push or DM (Device Management) sub-systems where data is not needed to understand semanticly. Processing the installation task can be synchronous or asynchronous. Synchronous mode is applied everytime an installation is initiated. Application Theme may include resources. Importing these resources to the target device may need conversions. Such resources like some audio files etc., can be imported directly, however, most of the image-resources must be fitted for the target device because target screen device's color depth and/or pixel density varies. In this case, the needed conversions will be executed asynchronously. Asynchronous installation is executed in phases - resource by resource. Client application must initiate asynchronous mode by calling hspsInstallNextPhaseL() after testing that the synchronous call hspsInstallTheme() has returned EhspsInstallPhaseSuccess return code. This means that there are resources to convert asynchronoulsly. The rest of the asynchronous installation phases will be executed automatically, however, installation can be interrupted by calling hspsCancelInstallTheme() at any time. If installation is canceled, installation handler initiates roll-back functionality removing inconsistent installation. Installation Service uses specific manifest-file format to get informed about the xml, css, dtd, and resource files to be installed. Resource files might be locale-specific or generic as well. HSPS Definition Repository takes care of saving everything on their appropriate places in the target device. Repository, i.e. theme storage, is loacted on hspsThemeServer's private-folder. The storage is organized by the information contained in ODT-header. Locales are instructed in manifest file also. Manifest file's file-extension must be .dat, but actually, the file-name can be whatever, however, when low-level parametrization is used, the name must be "manifest.dat" and it must be the last file extracted from the installation package. For more information of manifest-file format, see "HSPS Manifest File User Guide.doc".

Installation functions can return one of the following ThspsServiceCompletedMessage-codes:

EhspsInstallThemeSuccess,
EhspsInstallPhaseSuccess, or
EhspsInstallThemeFailed.

Client application must implement MhspsThemeManagementServiceObserver-interface and listen the messages mentionaed. Let it be emphasised that both synchronous and asynchronous calls can return the codes above. Installation functions may also return one of the following codes:

EhspsServiceRequestSheduled, or
EhspsServiceRequestError.

For explanation of the meanings of these messages, see ThspsServiceCompletedMessage-documentation.

hspsThemeServer.exe

Since: S60 5.0

Inherits from

ChspsInstallationHandler
- CBase

Public Member Functions
	~ChspsInstallationHandler()
TBool	CheckAutoInstallationValidityL()
void	DisableNotifications()
void	DisableUdaEmmcInstallations()
void	DoInstallThemeL(const TDesC &)
TAny *	GetExtendedInterface(const TInt32)
ChspsInstallationHandler *	NewL(ChspsThemeServer &)
ChspsInstallationHandler *	NewLC(ChspsThemeServer &)
void	OnContentL(const TDesC8 &, TInt)
void	OnEndDocumentL(TInt)
void	OnEndElementL(const RTagInfo &, TInt)
void	OnEndPrefixMappingL(const RString &, TInt)
void	OnError(TInt)
void	OnIgnorableWhiteSpaceL(const TDesC8 &, TInt)
void	OnProcessingInstructionL(const TDesC8 &, const TDesC8 &, TInt)
void	OnSkippedEntityL(const RString &, TInt)
void	OnStartDocumentL(const RDocumentParameters &, TInt)
void	OnStartElementL(const RTagInfo &, const RAttributeArray &, TInt)
void	OnStartPrefixMappingL(const RString &, const RString &, TInt)
void	ServiceInstallNextPhaseL(const RMessage2 &)
void	ServiceInstallThemeL(const RMessage2 &)
ThspsServiceCompletedMessage	hspsCancelInstallTheme()
void	hspsInstallNextPhaseL(TDes8 &, TRequestStatus &)
ThspsServiceCompletedMessage	hspsInstallNextPhaseL(ChspsODT &)
ThspsServiceCompletedMessage	hspsInstallNextPhaseL(TDes8 &)
ThspsServiceCompletedMessage	hspsInstallTheme(const TDesC &, ChspsODT &)
ThspsServiceCompletedMessage	hspsInstallTheme(const TDesC &, TDes8 &)

Protected Member Functions
void	RollBackL(ChspsODT &)

Private Member Functions
	ChspsInstallationHandler(ChspsThemeServer &)
void	ActivateThemeL()
void	AddDtdFileL(const TDesC &, const TLanguage)
void	AddInterfaceResourcesV2L(const TDesC &)
void	AddLocalesL(const TDesC &, const TBool)
void	AddResourceL(CArrayPtrSeg< ChspsResource > &, const TPtrC, const TLanguage, const ThspsResourceType, const TPtrC8, const TPtrC8)
void	AppendPluginConfigurationsL(ChspsODT &)
void	ApplyUidRangeTestsL(const TUint)
void	CheckHeaderL()
void	CleanupL(const ChspsODT &)
void	CompleteRequestL(const ThspsServiceCompletedMessage, const TDesC8 &)
void	ConstructL()
void	FinalizeParsingL()
void	FindResourceFilesL(const TDesC &, const TBool, RArray< TInt > &, CArrayFixFlat< TInt > *)
void	GetActiveAppConfsL(CArrayPtrSeg< ChspsODT > &)
TFileName	GetInterfacePath()
void	ImportPluginsL()
void	InstallSkeletonL(ThspsServiceCompletedMessage &)
TBool	IsPluginUsedInAppConfsL()
void	NotifyOdtUpdatedL()
void	ParseDocumentL(ChspsODT &)
void	ParseIconDeclarationL(HBufC8 &, const TDesC8 &, HBufC *&)
void	ResetL()
void	SetODTAsResourceL(ChspsODT &)

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()

Private Member Enumerations
enum	TInstallationType { EInstallationTypeNew = 0, EInstallationTypeUpdate }

Public Attributes
ChspsResult *	iResult

Private Attributes
HBufC8 *	iApplicationType
CRepository &	iCentralRepository
ThspsConfigurationType	iConfigurationType
HBufC8 *	iContent
ChspsDefinitionEngineInterface *	iDefEngine
TLanguage	iDefaultSpecification
TBool	iDefaultSpecificationSet
ChspsDefinitionRepository &	iDefinitionRepository
TBool	iDisableNotifications
HBufC *	iDtdFile
TUint32	iFamilyMask
TBool	iFileNotFound
RFs	iFsSession
HBufC8 *	iHeaderData
CArrayPtrSeg< ChspsODT > &	iHeaderListCache
TBool	iInstallFromUDAEmmc
TInstallationMode	iInstallationMode
ThspsInstallationPhase	iInstallationPhase
TInstallationType	iInstallationType
TBool	iLocalized
HBufC8 *	iMediaType
RMessagePtr2	iMessagePtr
TInt32	iMultiInstance
TBool	iMultiInstanceFound
ChspsODT *	iOdt
TBool	iPackageVerSupported
HBufC *	iPackageVersion
TUint	iProviderUid
TRequestStatus *	iRequestStatus
ChspsResource *	iResource
CArrayPtrSeg< ChspsResource > *	iResourceList
HBufC8 *	iResourceTag
TBuf8< KMaxResultDataLength8 >	iResultData
TUint	iRootUid
ChspsSecurityEnforcer &	iSecurityEnforcer
CArrayPtrSeg< ChspsResource > *	iTempLocalizedResourceList
HBufC8 *	iThemeDesc
TPath	iThemeFilePath
HBufC *	iThemeFullName
ChspsThemeServer &	iThemeServer
HBufC8 *	iThemeShortName
TUint32	iThemeStatus
TUint	iThemeUid
HBufC8 *	iThemeVersion
TBool	iTrustedInstallation
HBufC *	iXmlFile
Xml::CParser *	iXmlParser

Constructor & Destructor Documentation

ChspsInstallationHandler(ChspsThemeServer &)

ChspsInstallationHandler

(

ChspsThemeServer &

aThemeServer

)

[private]

C++ default constructor.

Since: S60 5.0

Parameters

ChspsThemeServer & aThemeServer

~ChspsInstallationHandler()

~ChspsInstallationHandler

(

)

Destructor.

Member Functions Documentation

ActivateThemeL()

void

ActivateThemeL

(

)

[private]

ActivateThemeL Activates the installed theme.

Since: S60 5.0

AddDtdFileL(const TDesC &, const TLanguage)

void	AddDtdFileL	(	const TDesC &	aPath,
			const TLanguage	aLanguage
		)	[private]

Adds localized dtd resources from the provided subdirectory

Since: S60 5.0

Parameters

const TDesC & aPath	Path to the subdirectory where the locale specific resources can be found
const TLanguage aLanguage	Name of the subdirectory

AddInterfaceResourcesV2L(const TDesC &)

void

AddInterfaceResourcesV2L

(

const TDesC &

aPath

)

[private]

Finds all language specific folders and resources under the interface path in ROM or UDA drive.

Since: S60 5.0 aPath Xuikon path

Parameters

const TDesC & aPath

AddLocalesL(const TDesC &, const TBool)

void	AddLocalesL	(	const TDesC &	aPath,
			const TBool	aProcessOnlyDTD
		)	[private]

Finds locale specific subdirectories and resources and appends those into the resource array

Since: S60 5.0

Parameters

const TDesC & aPath	is a directory where the locale specific subdirectories exits
const TBool aProcessOnlyDTD	If ETrue, then only DTD files are processed.

AddResourceL(CArrayPtrSeg< ChspsResource > &, const TPtrC, const TLanguage, const ThspsResourceType, const TPtrC8, const TPtrC8)

void	AddResourceL	(	CArrayPtrSeg< ChspsResource > &	aArray,
			const TPtrC	aFilename,
			const TLanguage	aLanguage,
			const ThspsResourceType	aResourceType,
			const TPtrC8	aMimetype,
			const TPtrC8	aTag
		)	[private]

Adds parsed resource into a temporary resource list, from which the resources are applied to an ODT instance at later phase

Since: S60 5.0

Parameters

CArrayPtrSeg< ChspsResource > & aArray	is either iResourceArray or iLocalizedResourceArray instance
const TPtrC aFilename	is full path and filename to the resource in an installation folder
const TLanguage aLanguage	is language of the resource (use ELangNone if it's a common resource)
const ThspsResourceType aResourceType	is MIME type or NULL
const TPtrC8 aMimetype	(Optional)
const TPtrC8 aTag	(Optional)

AppendPluginConfigurationsL(ChspsODT &)

void

AppendPluginConfigurationsL

(

ChspsODT &

aAppODT

)

[private]

Parses given DOM document and appends it with a content from possible plugin DOMs.

Since: S60 5.0

Parameters

ChspsODT & aAppODT

is the ODT which should be modified

ApplyUidRangeTestsL(const TUint)

void

ApplyUidRangeTestsL

(

const TUint

aUid

)

[private]

Validates provided UID value.

Parameters

const TUint aUid

Value to be checked

CheckAutoInstallationValidityL()

TBool

CheckAutoInstallationValidityL

(

)

CheckAutoInstallationValidityL Checks if auto installation of a theme is permitted

Since: S60 5.0 This is server-side only function.

CheckHeaderL()

void

CheckHeaderL

(

)

[private]

CheckHeaderL Checks the header information and stores it to iOdt

Since: S60 5.0

CleanupL(const ChspsODT &)

void

CleanupL

(

const ChspsODT &

aUpdateMask

)

[private]

CleanupL Executes cleaning of the target folder prior to the installation process

Since: S60 5.0

Parameters

const ChspsODT & aUpdateMask

CompleteRequestL(const ThspsServiceCompletedMessage, const TDesC8 &)

void	CompleteRequestL	(	const ThspsServiceCompletedMessage	aReturnMessage,
			const TDesC8 &	aHeaderData = KNullDesC8
		)	[private]

CompleteRequestL Completes the request message

Since: S60 5.0

Parameters

const ThspsServiceCompletedMessage aReturnMessage
const TDesC8 & aHeaderData = KNullDesC8

ConstructL()

void

ConstructL

(

)

[private]

By default Symbian 2nd phase constructor is private.

Since: S60 5.0

DisableNotifications()

void

DisableNotifications

(

)

Disables "configuration was installed" notifications

Since: S60 5.0

DisableUdaEmmcInstallations()

void

DisableUdaEmmcInstallations

(

)

Disables installation of UDA and eMMC content.

Since: S60 5.2

DoInstallThemeL(const TDesC &)

void

DoInstallThemeL

(

const TDesC &

aManifest

)

Parses the manifest file and requests installation of next phases.

Since: S60 5.2

Parameters

const TDesC & aManifest

is full path of the installation script file - a manifest file

FinalizeParsingL()

void

FinalizeParsingL

(

)

[private]

Validates manifest contents and installs files into the Plug-in Repository.

Since: S60 5.0

FindResourceFilesL(const TDesC &, const TBool, RArray< TInt > &, CArrayFixFlat< TInt > *)

void	FindResourceFilesL	(	const TDesC &	aPath,
			const TBool	aRecursive,
			RArray< TInt > &	aDriveArray,
			CArrayFixFlat< TInt > *	aDeviceLanguages
		)	[private]

Find resource files

Since: S60 5.0

Parameters

const TDesC & aPath	Path to files
const TBool aRecursive	Is recursive search
RArray< TInt > & aDriveArray	Drives to search
CArrayFixFlat< TInt > * aDeviceLanguages	Required languages

GetActiveAppConfsL(CArrayPtrSeg< ChspsODT > &)

void

GetActiveAppConfsL

(

CArrayPtrSeg< ChspsODT > &

aActiveAppConfs

)

[private]

Get active application configurations.

Since: S60 5.0

Parameters

CArrayPtrSeg< ChspsODT > & aActiveAppConfs

Target list for active application configurations.

GetExtendedInterface(const TInt32)

TAny *

GetExtendedInterface

(

const TInt32

aUid

)

[inline]

GetExtendedInterface

Since: S60 5.0 This method obtains the interface matching the specified uid.

Parameters

const TInt32 aUid

the uid identifying the required interface.

GetInterfacePath()

TFileName

GetInterfacePath

(

)

[private]

Returns a path if V2 directory structure is in use and if an interface uid is known.

ImportPluginsL()

void

ImportPluginsL

(

)

[private]

ImportPluginsL Imports plug-in DOMs referenced by application configuration, other configuration types are ignored.

Since: S60 5.0

InstallSkeletonL(ThspsServiceCompletedMessage &)

void

InstallSkeletonL

(

ThspsServiceCompletedMessage &

aReturnMsg

)

[private]

InstallOdtL Installs the theme skeleton

Since: S60 5.0

Parameters

ThspsServiceCompletedMessage & aReturnMsg

IsPluginUsedInAppConfsL()

TBool

IsPluginUsedInAppConfsL

(

)

[private]

Indicated whether installed plugin was instansiated in one or more application configurations.

Since: S60 5.0

NewL(ChspsThemeServer &)

ChspsInstallationHandler *

NewL

(

ChspsThemeServer &

aThemeServer

)

[static]

Two-phased constructor.

Parameters

ChspsThemeServer & aThemeServer

NewLC(ChspsThemeServer &)

ChspsInstallationHandler *

NewLC

(

ChspsThemeServer &

aThemeServer

)

[static]

Parameters

ChspsThemeServer & aThemeServer

NotifyOdtUpdatedL()

void

NotifyOdtUpdatedL

(

)

[private]

Send update notifications if necessary.

Since: S60 5.0

OnContentL(const TDesC8 &, TInt)

void	OnContentL	(	const TDesC8 &	aBytes,
			TInt	aErrorCode
		)

OnContentL

Since: S60 5.0 This method is a callback that sends the content of the element. Not all the content may be returned in one go. The data may be sent in chunks. When an OnEndElementL is received this means there is no more content to be sent.

Parameters

const TDesC8 & aBytes	is the raw content data for the element. The client is responsible for converting the data to the required character set if necessary. In some instances the content may be binary and must not be converted.
TInt aErrorCode	is the error code. If this is not KErrNone then special action may be required.

OnEndDocumentL(TInt)

void

OnEndDocumentL

(

TInt

aErrorCode

)

[inline]

OnEndDocumentL

Since: S60 5.0 This method is a callback to indicate the end of the document.

Parameters

TInt aErrorCode

is the error code. If this is not KErrNone then special action may be required.

OnEndElementL(const RTagInfo &, TInt)

void	OnEndElementL	(	const RTagInfo &	aElement,
			TInt	aErrorCode
		)

OnEndElementL

Since: S60 5.0 This method is a callback to indicate the end of the element has been reached.

Parameters

const RTagInfo & aElement	is a handle to the element's details.
TInt aErrorCode	is the error code. If this is not KErrNone then special action may be required.

OnEndPrefixMappingL(const RString &, TInt)

void	OnEndPrefixMappingL	(	const RString &	aPrefix,
			TInt	aErrorCode
		)	[inline]

OnEndPrefixMappingL

Since: S60 5.0 This method is a notification of the end of the scope of a prefix-URI mapping. This method is called after the corresponding DoEndElementL method.

Parameters

const RString & aPrefix	is the Namespace prefix that was mapped.
TInt aErrorCode	is the error code. If this is not KErrNone then special action may be required.

OnError(TInt)

void

OnError

(

TInt

aErrorCode

)

[inline]

OnError

Since: S60 5.0 This method indicates an error has occurred.

Parameters

TInt aErrorCode

OnIgnorableWhiteSpaceL(const TDesC8 &, TInt)

void	OnIgnorableWhiteSpaceL	(	const TDesC8 &	aBytes,
			TInt	aErrorCode
		)	[inline]

OnIgnorableWhiteSpaceL

Since: S60 5.0 This method is a notification of ignorable whitespace in element content.

Parameters

const TDesC8 & aBytes	are the ignored bytes from the document being parsed.
TInt aErrorCode	is the error code. If this is not KErrNone then special action may be required.

OnProcessingInstructionL(const TDesC8 &, const TDesC8 &, TInt)

void	OnProcessingInstructionL	(	const TDesC8 &	aTarget,
			const TDesC8 &	aData,
			TInt	aErrorCode
		)	[inline]

OnProcessingInstructionL

Since: S60 5.0 This method is a receive notification of a processing instruction.

Parameters

const TDesC8 & aTarget	is the processing instruction target.
const TDesC8 & aData	is the processing instruction data. If empty none was supplied.
TInt aErrorCode	is the error code. If this is not KErrNone then special action may be required.

OnSkippedEntityL(const RString &, TInt)

void	OnSkippedEntityL	(	const RString &	aName,
			TInt	aErrorCode
		)	[inline]

OnSkippedEntityL

Since: S60 5.0 This method is a notification of a skipped entity. If the parser encounters an external entity it does not need to expand it - it can return the entity as aName for the client to deal with.

Parameters

const RString & aName	is the name of the skipped entity.
TInt aErrorCode	is the error code. If this is not KErrNone then special action may be required.

OnStartDocumentL(const RDocumentParameters &, TInt)

void	OnStartDocumentL	(	const RDocumentParameters &	aDocParam,
			TInt	aErrorCode
		)	[inline]

OnStartDocumentL

Since: S60 5.0 This method is a callback to indicate the start of the document.

Parameters

const RDocumentParameters & aDocParam	Specifies the various parameters of the document. aDocParam.iCharacterSetName The character encoding of the document.
TInt aErrorCode	is the error code. If this is not KErrNone then special action may be required.

OnStartElementL(const RTagInfo &, const RAttributeArray &, TInt)

void	OnStartElementL	(	const RTagInfo &	aElement,
			const RAttributeArray &	aAttributes,
			TInt	aErrorCode
		)

OnStartElementL

Since: S60 5.0 This method is a callback to indicate an element has been parsed.

Parameters

const RTagInfo & aElement	is a handle to the element's details.
const RAttributeArray & aAttributes	contains the attributes for the element.
TInt aErrorCode	is the error code. If this is not KErrNone then special action may be required.

OnStartPrefixMappingL(const RString &, const RString &, TInt)

void	OnStartPrefixMappingL	(	const RString &	aPrefix,
			const RString &	aUri,
			TInt	aErrorCode
		)	[inline]

OnStartPrefixMappingL

Since: S60 5.0 This method is a notification of the beginning of the scope of a prefix-URI Namespace mapping. This method is always called before the corresponding OnStartElementL method.

Parameters

const RString & aPrefix	is the Namespace prefix being declared.
const RString & aUri	is the Namespace URI the prefix is mapped to.
TInt aErrorCode	is the error code. If this is not KErrNone then special action may be required.

ParseDocumentL(ChspsODT &)

void

ParseDocumentL

(

ChspsODT &

aOdt

)

[private]

ParseDocumentL Calls the definition engine to create the dom

Since: S60 5.0

Parameters

ChspsODT & aOdt

ParseIconDeclarationL(HBufC8 &, const TDesC8 &, HBufC *&)

void	ParseIconDeclarationL	(	HBufC8 &	aValue8,
			const TDesC8 &	aTag,
			HBufC *&	aResultString
		)	[private]

Parser for the filelogo and filepreview elements in manifest files. If an icon was provided, it is added to an resource array for copying to client's private folder. Allocates heap for the result. Supported values:

skin(<major id> <minor id>):mif(<path> <bitmapid> <maskid>)
mif(<path> <bitmapid> <maskid>)
uid(<application uid>)
<file name>="">.<png/svg>

Parameters

HBufC8 & aValue8	Value of the element
const TDesC8 & aTag	A tag for the file resource
HBufC *& aResultString	Fixed declaration with a valid path reference

ResetL()

void

ResetL

(

)

[private]

Resets memeber variables. Used by the autoinstaller when installation handler is created only once.

Since: S60 5.0

RollBackL(ChspsODT &)

void

RollBackL

(

ChspsODT &

aOdt

)

[protected]

Rolls back the installation if it fails or is cancelled.

Since: S60 5.0

Parameters

ChspsODT & aOdt

The ODT of the theme

ServiceInstallNextPhaseL(const RMessage2 &)

void

ServiceInstallNextPhaseL

(

const RMessage2 &

aMessage

)

ServiceInstallNextPhaseL Starts subsequent installation phases.

Since: S60 5.0

Parameters

const RMessage2 & aMessage

Message from client

ServiceInstallThemeL(const RMessage2 &)

void

ServiceInstallThemeL

(

const RMessage2 &

aMessage

)

ServiceInstallThemeL Starts the actual installation in ChspsInstallationHandler.

Since: S60 5.0

Parameters

const RMessage2 & aMessage

Message from client

SetODTAsResourceL(ChspsODT &)

void

SetODTAsResourceL

(

ChspsODT &

aOdt

)

[private]

SetODTAsResourceL Stores the given ODT as a resources on the resource list

Since: S60 5.0

Parameters

ChspsODT & aOdt

hspsCancelInstallTheme()

ThspsServiceCompletedMessage

hspsCancelInstallTheme

(

)

From MhspsInstallationService hspsCancelInstallTheme

Since: S60 5.0

hspsInstallNextPhaseL(TDes8 &, TRequestStatus &)

void	hspsInstallNextPhaseL	(	TDes8 &	aHeaderData,
			TRequestStatus &	aRequestStatus
		)

hspsInstallNextPhase

Since: S60 5.0 This is server-side only function.

Parameters

TDes8 & aHeaderData	will return ODT-header of the latest installation phase in serialized (i.e. marshalled) data mode. This follows the low-level parametrization schema.
TRequestStatus & aRequestStatus	will return the status of the asynchronous request returned by installer.

hspsInstallNextPhaseL(ChspsODT &)

ThspsServiceCompletedMessage

hspsInstallNextPhaseL

(

ChspsODT &

)

[inline]

From MhspsInstallationService hspsInstallNextPhaseL

Since: S60 5.0

Parameters

ChspsODT &

hspsInstallNextPhaseL(TDes8 &)

ThspsServiceCompletedMessage

hspsInstallNextPhaseL

(

TDes8 &

aHeaderData

)

From MhspsInstallationService hspsInstallNextPhaseL

Since: S60 5.0

Parameters

TDes8 & aHeaderData

will return ODT-header of the latest installation phase in serialized (i.e. marshalled) data mode. This follows the low-level parametrization schema.

hspsInstallTheme(const TDesC &, ChspsODT &)

ThspsServiceCompletedMessage	hspsInstallTheme	(	const TDesC &	,
			ChspsODT &
		)	[inline]

From MhspsInstallationService hspsInstallTheme

Since: S60 5.0

Parameters

const TDesC &
ChspsODT &

hspsInstallTheme(const TDesC &, TDes8 &)

ThspsServiceCompletedMessage	hspsInstallTheme	(	const TDesC &	aManifestFileName,
			TDes8 &	aHeaderData
		)

From MhspsInstallationService hspsInstallTheme

Since: S60 5.0

Parameters

const TDesC & aManifestFileName	is full path of the installation script file - a manifest file
TDes8 & aHeaderData	will return ODT-header of the newly installed theme in serialized (i.e. marshalled) data mode. This follows the low-level parametrization schema.

Member Enumerations Documentation

Enum TInstallationType

Installation type.

Enumerators

EInstallationTypeNew = 0
EInstallationTypeUpdate

Member Data Documentation

HBufC8 * iApplicationType

HBufC8 *

iApplicationType

[private]

CRepository & iCentralRepository

CRepository &

iCentralRepository

[private]

ThspsConfigurationType iConfigurationType

ThspsConfigurationType

iConfigurationType

[private]

HBufC8 * iContent

HBufC8 *

iContent

[private]

ChspsDefinitionEngineInterface * iDefEngine

ChspsDefinitionEngineInterface *

iDefEngine

[private]

TLanguage iDefaultSpecification

TLanguage

iDefaultSpecification

[private]

TBool iDefaultSpecificationSet

TBool

iDefaultSpecificationSet

[private]

ChspsDefinitionRepository & iDefinitionRepository

ChspsDefinitionRepository &

iDefinitionRepository

[private]

TBool iDisableNotifications

TBool

iDisableNotifications

[private]

HBufC * iDtdFile

HBufC *

iDtdFile

[private]

TUint32 iFamilyMask

TUint32

iFamilyMask

[private]

TBool iFileNotFound

TBool

iFileNotFound

[private]

RFs iFsSession

RFs

iFsSession

[private]

HBufC8 * iHeaderData

HBufC8 *

iHeaderData

[private]

CArrayPtrSeg< ChspsODT > & iHeaderListCache

CArrayPtrSeg< ChspsODT > &

iHeaderListCache

[private]

TBool iInstallFromUDAEmmc

TBool

iInstallFromUDAEmmc

[private]

TInstallationMode iInstallationMode

TInstallationMode

iInstallationMode

[private]

ThspsInstallationPhase iInstallationPhase

ThspsInstallationPhase

iInstallationPhase

[private]

TInstallationType iInstallationType

TInstallationType

iInstallationType

[private]

TBool iLocalized

TBool

iLocalized

[private]

HBufC8 * iMediaType

HBufC8 *

iMediaType

[private]

RMessagePtr2 iMessagePtr

RMessagePtr2

iMessagePtr

[private]

TInt32 iMultiInstance

TInt32

iMultiInstance

[private]

TBool iMultiInstanceFound

TBool

iMultiInstanceFound

[private]

ChspsODT * iOdt

ChspsODT *

iOdt

[private]

TBool iPackageVerSupported

TBool

iPackageVerSupported

[private]

HBufC * iPackageVersion

HBufC *

iPackageVersion

[private]

TUint iProviderUid

TUint

iProviderUid

[private]

TRequestStatus * iRequestStatus

TRequestStatus *

iRequestStatus

[private]

ChspsResource * iResource

ChspsResource *

iResource

[private]

CArrayPtrSeg< ChspsResource > * iResourceList

CArrayPtrSeg< ChspsResource > *

iResourceList

[private]

HBufC8 * iResourceTag

HBufC8 *

iResourceTag

[private]

ChspsResult * iResult

ChspsResult *

iResult

TBuf8< KMaxResultDataLength8 > iResultData

TBuf8< KMaxResultDataLength8 >

iResultData

[private]

TUint iRootUid

TUint

iRootUid

[private]

ChspsSecurityEnforcer & iSecurityEnforcer

ChspsSecurityEnforcer &

iSecurityEnforcer

[private]

CArrayPtrSeg< ChspsResource > * iTempLocalizedResourceList

CArrayPtrSeg< ChspsResource > *

iTempLocalizedResourceList

[private]

HBufC8 * iThemeDesc

HBufC8 *

iThemeDesc

[private]

TPath iThemeFilePath

TPath

iThemeFilePath

[private]

HBufC * iThemeFullName

HBufC *

iThemeFullName

[private]

ChspsThemeServer & iThemeServer

ChspsThemeServer &

iThemeServer

[private]

HBufC8 * iThemeShortName

HBufC8 *

iThemeShortName

[private]

TUint32 iThemeStatus

TUint32

iThemeStatus

[private]

TUint iThemeUid

TUint

iThemeUid

[private]

HBufC8 * iThemeVersion

HBufC8 *

iThemeVersion

[private]

TBool iTrustedInstallation

TBool

iTrustedInstallation

[private]

HBufC * iXmlFile

HBufC *

iXmlFile

[private]

Xml::CParser * iXmlParser

Xml::CParser *

iXmlParser

[private]