Collapse all Symbian^3 Product Developer Library

SwiUI::RSWInstLauncher Class Reference

class SwiUI::RSWInstLauncher : public RAknAppServiceBase

Client side handle to access SW Installer UI services.

swinst.lib

Since: 3.0

Inherits from

SwiUI::RSWInstLauncher
- RAknAppServiceBase
  - REikAppServiceBase
    - RApaAppServiceBase
      - RSessionBase
        RHandleBase

Public Member Functions
	RSWInstLauncher()
IMPORT_C TInt	CancelAsyncRequest(TInt)
IMPORT_C void	Close()
IMPORT_C TInt	Connect()
IMPORT_C TInt	CustomUninstall(TOperation, const TDesC8 &, const TDesC8 &)
IMPORT_C void	CustomUninstall(TRequestStatus &, TOperation, const TDesC8 &, const TDesC8 &)
IMPORT_C CErrDetails *	GetLastErrorL()
IMPORT_C TInt	Install(const TDesC &)
IMPORT_C void	Install(TRequestStatus &, const TDesC &)
IMPORT_C TInt	Install(RFile &)
IMPORT_C void	Install(TRequestStatus &, RFile &)
IMPORT_C TInt	Install(const TDesC &, const TDesC8 &)
IMPORT_C void	Install(TRequestStatus &, const TDesC &, const TDesC8 &)
IMPORT_C TInt	Install(RFile &, const TDesC8 &)
IMPORT_C void	Install(TRequestStatus &, RFile &, const TDesC8 &)
IMPORT_C TInt	SilentCustomUninstall(TOperation, const TDesC8 &, const TDesC8 &, const TDesC8 &)
IMPORT_C void	SilentCustomUninstall(TRequestStatus &, TOperation, const TDesC8 &, const TDesC8 &, const TDesC8 &)
IMPORT_C TInt	SilentInstall(const TDesC &, const TDesC8 &)
IMPORT_C void	SilentInstall(TRequestStatus &, const TDesC &, const TDesC8 &)
IMPORT_C TInt	SilentInstall(RFile &, const TDesC8 &)
IMPORT_C void	SilentInstall(TRequestStatus &, RFile &, const TDesC8 &)
IMPORT_C TInt	SilentInstall(const TDesC &, const TDesC8 &, const TDesC8 &)
IMPORT_C void	SilentInstall(TRequestStatus &, const TDesC &, const TDesC8 &, const TDesC8 &)
IMPORT_C TInt	SilentInstall(RFile &, const TDesC8 &, const TDesC8 &)
IMPORT_C void	SilentInstall(TRequestStatus &, RFile &, const TDesC8 &, const TDesC8 &)
IMPORT_C TInt	SilentUninstall(const TUid &, const TDesC8 &, const TDesC8 &)
IMPORT_C void	SilentUninstall(TRequestStatus &, const TUid &, const TDesC8 &, const TDesC8 &)
IMPORT_C TInt	Uninstall(const TUid &, const TDesC8 &)
IMPORT_C void	Uninstall(TRequestStatus &, const TUid &, const TDesC8 &)

Protected Member Functions
void	PanicClient(TInt)

Private Member Functions
TUid	ServiceUid()

Inherited Functions
	RAknAppServiceBase::ConnectChainedAppL(TUid)
	RApaAppServiceBase::CancelNotifyServerExit()const
	RApaAppServiceBase::ConnectExistingAppL(const RApaAppServiceBase &)
	RApaAppServiceBase::ConnectExistingAppL(const RApaAppServiceBase &,const TSecurityPolicy &)
	RApaAppServiceBase::ConnectExistingByNameL(const TDesC &)
	RApaAppServiceBase::ConnectExistingByNameL(const TDesC &,const TSecurityPolicy &)
	RApaAppServiceBase::NotifyServerExit(TRequestStatus &)const
	RApaAppServiceBase::RApaAppServiceBase()
	RApaAppServiceBase::ServerName()const
	RApaAppServiceBase::TransferExistingSessionL(RApaAppServiceBase &)
	REikAppServiceBase::ConnectNewAppL(TUid)
	REikAppServiceBase::ConnectNewAppL(TUid,const TSecurityPolicy &)
	REikAppServiceBase::ConnectNewChildAppL(TUid,RWindowGroup &)
	REikAppServiceBase::ConnectNewChildAppL(TUid,RWindowGroup &,const TSecurityPolicy &)
	RHandleBase::Attributes()const
	RHandleBase::BTraceId()const
	RHandleBase::DoExtendedClose()
	RHandleBase::Duplicate(const RThread &,TOwnerType)
	RHandleBase::FullName()const
	RHandleBase::FullName(TDes &)const
	RHandleBase::Handle()const
	RHandleBase::HandleInfo(THandleInfo *)
	RHandleBase::Name()const
	RHandleBase::NotifyDestruction(TRequestStatus &)
	RHandleBase::Open(const TFindHandleBase &,TOwnerType)
	RHandleBase::OpenByName(const TDesC &,TOwnerType,TInt)
	RHandleBase::RHandleBase()
	RHandleBase::RHandleBase(TInt)
	RHandleBase::SetHandle(TInt)
	RHandleBase::SetHandleNC(TInt)
	RSessionBase::CreateSession(RServer2,const TVersion &)
	RSessionBase::CreateSession(RServer2,const TVersion &,TInt)
	RSessionBase::CreateSession(RServer2,const TVersion &,TInt,TIpcSessionType,const TSecurityPolicy ,TRequestStatus )
	RSessionBase::CreateSession(const TDesC &,const TVersion &)
	RSessionBase::CreateSession(const TDesC &,const TVersion &,TInt)
	RSessionBase::CreateSession(const TDesC &,const TVersion &,TInt,TIpcSessionType,const TSecurityPolicy ,TRequestStatus )
	RSessionBase::CreateSession(const TDesC &,const TVersion &,TInt,TRequestStatus *)
	RSessionBase::Open(RMessagePtr2,TInt,TOwnerType)
	RSessionBase::Open(RMessagePtr2,TInt,const TSecurityPolicy &,TOwnerType)
	RSessionBase::Open(TInt,TOwnerType)
	RSessionBase::Open(TInt,const TSecurityPolicy &,TOwnerType)
	RSessionBase::Send(TInt)const
	RSessionBase::Send(TInt,const TIpcArgs &)const
	RSessionBase::SendReceive(TInt)const
	RSessionBase::SendReceive(TInt,TRequestStatus &)const
	RSessionBase::SendReceive(TInt,const TIpcArgs &)const
	RSessionBase::SendReceive(TInt,const TIpcArgs &,TRequestStatus &)const
	RSessionBase::SetReturnedHandle(TInt)
	RSessionBase::SetReturnedHandle(TInt,RHandleBase &)
	RSessionBase::SetReturnedHandle(TInt,const TSecurityPolicy &)
	RSessionBase::ShareAuto()
	RSessionBase::ShareProtected()

Inherited Enumerations
	RApaAppServiceBase:TApaAppServiceBaseCmdConstants
	RHandleBase:TAttributes
	RSessionBase:TAttachMode

Protected Attributes
TBool	iConnected

Private Attributes
TAny *	reserved1
TAny *	reserved2

Inherited Attributes
	RHandleBase::iHandle

Constructor & Destructor Documentation

RSWInstLauncher()

IMPORT_C

RSWInstLauncher

(

)

Constructor.

Member Functions Documentation

CancelAsyncRequest(TInt)

IMPORT_C TInt

CancelAsyncRequest

(

TInt

aReqToCancel

)

Cancel Asynchronous requests

Since: 3.0

Parameters

TInt aReqToCancel

Close()

IMPORT_C void

(

)

Closes the connection to the server and close the installer server application.

Since: 3.0

Connect()

IMPORT_C TInt

Connect

(

)

Creates connection to the server. This will launch the installer as server application.

Since: 3.0

CustomUninstall(TOperation, const TDesC8 &, const TDesC8 &)

IMPORT_C TInt	CustomUninstall	(	TOperation	aOperation,
			const TDesC8 &	aParams,
			const TDesC8 &	aMIME
		)

Performs a custom uninstallation.

Since: 3.0

Parameters

TOperation aOperation	- The operation to be performed.
const TDesC8 & aParams	- Parameters for the operation
const TDesC8 & aMIME

CustomUninstall(TRequestStatus &, TOperation, const TDesC8 &, const TDesC8 &)

IMPORT_C void	CustomUninstall	(	TRequestStatus &	aReqStatus,
			TOperation	aOperation,
			const TDesC8 &	aParams,
			const TDesC8 &	aMIME
		)

Asynchronous version To cancel the request, use CancelAsyncRequest with ERequestCustomUninstall.

Parameters

TRequestStatus & aReqStatus
TOperation aOperation
const TDesC8 & aParams
const TDesC8 & aMIME

GetLastErrorL()

IMPORT_C CErrDetails *

GetLastErrorL

(

)

Install(const TDesC &)

IMPORT_C TInt

Install

(

const TDesC &

aFileName

)

Start Installation of the package. The call will return when the installation if over.

Since: 3.0

Parameters

const TDesC & aFileName

- Path to the installation package

Install(TRequestStatus &, const TDesC &)

IMPORT_C void	Install	(	TRequestStatus &	aReqStatus,
			const TDesC &	aFileName
		)

Asynchronous version. The aReqStatus will be completed when installation is finished. To cancel the request, use CancelAsyncRequest with ERequestInstall.

Parameters

TRequestStatus & aReqStatus
const TDesC & aFileName

Install(RFile &)

IMPORT_C TInt

Install

(

RFile &

aFile

)

Start Installation of the package

Since: 3.0

Parameters

RFile & aFile

- Handle to the installation package.

Install(TRequestStatus &, RFile &)

IMPORT_C void	Install	(	TRequestStatus &	aReqStatus,
			RFile &	aFile
		)

Asynchronous version. To cancel the request, use CancelAsyncRequest with ERequestInstall.

Parameters

TRequestStatus & aReqStatus
RFile & aFile

Install(const TDesC &, const TDesC8 &)

IMPORT_C TInt	Install	(	const TDesC &	aFileName,
			const TDesC8 &	aParams
		)

Start Installation of the package

Since: 3.0

Parameters

const TDesC & aFileName	- Path to the installation package
const TDesC8 & aParams	- Installer parameters. Use TInstallReqPckg to package.

Install(TRequestStatus &, const TDesC &, const TDesC8 &)

IMPORT_C void	Install	(	TRequestStatus &	aReqStatus,
			const TDesC &	aFileName,
			const TDesC8 &	aParams
		)

Asynchronous version To cancel the request, use CancelAsyncRequest with ERequestInstallParams.

Parameters

TRequestStatus & aReqStatus
const TDesC & aFileName
const TDesC8 & aParams

Install(RFile &, const TDesC8 &)

IMPORT_C TInt	Install	(	RFile &	aFile,
			const TDesC8 &	aParams
		)

Start Installation of the package

Since: 3.0

Parameters

RFile & aFile	- Handle to the installation package.
const TDesC8 & aParams	- Installer parameters. Use TInstallReqPckg to package.

Install(TRequestStatus &, RFile &, const TDesC8 &)

IMPORT_C void	Install	(	TRequestStatus &	aReqStatus,
			RFile &	aFile,
			const TDesC8 &	aParams
		)

Asynchronous version To cancel the request, use CancelAsyncRequest with ERequestInstallParams.

Parameters

TRequestStatus & aReqStatus
RFile & aFile
const TDesC8 & aParams

PanicClient(TInt)

void

PanicClient

(

TInt

aPanic

)

const [protected]

Panics the client.

Since: 3.0

Parameters

TInt aPanic

- Panic ID.

ServiceUid()

TUid

ServiceUid

(

)

const [private, virtual]

From RApaAppServiceBase, Returns the UID of the service that this session provides an interface for.

Since: 3.0

SilentCustomUninstall(TOperation, const TDesC8 &, const TDesC8 &, const TDesC8 &)

IMPORT_C TInt	SilentCustomUninstall	(	TOperation	aOperation,
			const TDesC8 &	aOptions,
			const TDesC8 &	aParams,
			const TDesC8 &	aMIME
		)

Performs a silent custom uninstallation.

Since: 3.0

Parameters

TOperation aOperation	- The operation to be performed.
const TDesC8 & aOptions	- Default options for uninstallation.
const TDesC8 & aParams	- Parameters for the operation
const TDesC8 & aMIME

SilentCustomUninstall(TRequestStatus &, TOperation, const TDesC8 &, const TDesC8 &, const TDesC8 &)

IMPORT_C void	SilentCustomUninstall	(	TRequestStatus &	aReqStatus,
			TOperation	aOperation,
			const TDesC8 &	aOptions,
			const TDesC8 &	aParams,
			const TDesC8 &	aMIME
		)

Asynchronous version To cancel the request, use CancelAsyncRequest with ERequestSilentCustomUninstall.

Parameters

TRequestStatus & aReqStatus
TOperation aOperation
const TDesC8 & aOptions
const TDesC8 & aParams
const TDesC8 & aMIME

SilentInstall(const TDesC &, const TDesC8 &)

IMPORT_C TInt	SilentInstall	(	const TDesC &	aFileName,
			const TDesC8 &	aOptions
		)

Start silent installation of the package (client must have TrustedUI capabilities)

Since: future

Parameters

const TDesC & aFileName	- Path to the installation package
const TDesC8 & aOptions	- Default options for installation. Use TInstallOptionsPckg to package.

SilentInstall(TRequestStatus &, const TDesC &, const TDesC8 &)

IMPORT_C void	SilentInstall	(	TRequestStatus &	aReqStatus,
			const TDesC &	aFileName,
			const TDesC8 &	aOptions
		)

Asynchronous version To cancel the request, use CancelAsyncRequest with ERequestSilentInstall.

Parameters

TRequestStatus & aReqStatus
const TDesC & aFileName
const TDesC8 & aOptions

SilentInstall(RFile &, const TDesC8 &)

IMPORT_C TInt	SilentInstall	(	RFile &	aFile,
			const TDesC8 &	aOptions
		)

Start silent installation of the package (client must have TrustedUI capabilities)

Since: future

Parameters

RFile & aFile	- Handle to the installation package.
const TDesC8 & aOptions	- Default options for installation. Use TInstallOptionsPckg to package.

SilentInstall(TRequestStatus &, RFile &, const TDesC8 &)

IMPORT_C void	SilentInstall	(	TRequestStatus &	aReqStatus,
			RFile &	aFile,
			const TDesC8 &	aOptions
		)

Asynchronous version To cancel the request, use CancelAsyncRequest with ERequestSilentInstall.

Parameters

TRequestStatus & aReqStatus
RFile & aFile
const TDesC8 & aOptions

SilentInstall(const TDesC &, const TDesC8 &, const TDesC8 &)

IMPORT_C TInt	SilentInstall	(	const TDesC &	aFileName,
			const TDesC8 &	aParams,
			const TDesC8 &	aOptions
		)

Start silent installation of the package (client must have TrustedUI capabilities)

Since: future

Parameters

const TDesC & aFileName	- Path to the installation package
const TDesC8 & aParams	- Installer parameters. Use TInstallReqPckg to package.
const TDesC8 & aOptions	- Default options for installation. Use TInstallOptionsPckg to package.

SilentInstall(TRequestStatus &, const TDesC &, const TDesC8 &, const TDesC8 &)

IMPORT_C void	SilentInstall	(	TRequestStatus &	aReqStatus,
			const TDesC &	aFileName,
			const TDesC8 &	aParams,
			const TDesC8 &	aOptions
		)

Asynchronous version To cancel the request, use CancelAsyncRequest with ERequestSilentInstallParams.

Parameters

TRequestStatus & aReqStatus
const TDesC & aFileName
const TDesC8 & aParams
const TDesC8 & aOptions

SilentInstall(RFile &, const TDesC8 &, const TDesC8 &)

IMPORT_C TInt	SilentInstall	(	RFile &	aFile,
			const TDesC8 &	aParams,
			const TDesC8 &	aOptions
		)

Start silent installation of the package (client must have TrustedUI capabilities)

Since: future

Parameters

RFile & aFile	- Handle to the installation package.
const TDesC8 & aParams	- Installer parameters. Use TInstallReqPckg to package.
const TDesC8 & aOptions	- Default options for installation. Use TInstallOptionsPckg to package.

SilentInstall(TRequestStatus &, RFile &, const TDesC8 &, const TDesC8 &)

IMPORT_C void	SilentInstall	(	TRequestStatus &	aReqStatus,
			RFile &	aFile,
			const TDesC8 &	aParams,
			const TDesC8 &	aOptions
		)

Asynchronous version To cancel the request, use CancelAsyncRequest with ERequestSilentInstallParams.

Parameters

TRequestStatus & aReqStatus
RFile & aFile
const TDesC8 & aParams
const TDesC8 & aOptions

SilentUninstall(const TUid &, const TDesC8 &, const TDesC8 &)

IMPORT_C TInt	SilentUninstall	(	const TUid &	aUid,
			const TDesC8 &	aOptions,
			const TDesC8 &	aMIME
		)

Start silent UnInstallation of the package, (client must have TrustedUI capabilities)

Since: future

Parameters

const TUid & aUid	- uid of the installed package
const TDesC8 & aOptions	- Default options for uninstallation. Use TUninstallOptionsPckg to package.
const TDesC8 & aMIME	- Data type of the package to be uninstalled.

SilentUninstall(TRequestStatus &, const TUid &, const TDesC8 &, const TDesC8 &)

IMPORT_C void	SilentUninstall	(	TRequestStatus &	aReqStatus,
			const TUid &	aUid,
			const TDesC8 &	aOptions,
			const TDesC8 &	aMIME
		)

Asynchronous version To cancel the request, use CancelAsyncRequest with ERequestSilentUninstall.

Parameters

TRequestStatus & aReqStatus
const TUid & aUid
const TDesC8 & aOptions
const TDesC8 & aMIME

Uninstall(const TUid &, const TDesC8 &)

IMPORT_C TInt	Uninstall	(	const TUid &	aUid,
			const TDesC8 &	aMIME
		)

Start UnInstallation of the package

Since: future

Parameters

const TUid & aUid	- uid of the installed package
const TDesC8 & aMIME	- Data type of the package to be uninstalled.

Uninstall(TRequestStatus &, const TUid &, const TDesC8 &)

IMPORT_C void	Uninstall	(	TRequestStatus &	aReqStatus,
			const TUid &	aUid,
			const TDesC8 &	aMIME
		)

Asynchronous version To cancel the request, use CancelAsyncRequest with ERequestUninstall.

Parameters

TRequestStatus & aReqStatus
const TUid & aUid
const TDesC8 & aMIME

Member Data Documentation

TBool iConnected

TBool

iConnected

[protected]

TAny * reserved1

TAny *

reserved1

[private]

TAny * reserved2

TAny *

reserved2

[private]