Swi::RUissSession Class Reference

class Swi::RUissSession : public RSessionBase

Session to communicate with UISS in order to initiate installation or uninstallation. Used from SISHelper.

Inherits from

Public Member Functions
IMPORT_C void BufferReallocated ( TDes8 &, TRequestStatus &)
IMPORT_C TInt Cancel ()
IMPORT_C void CompleteDialog ( TInt , TDes8 &, TRequestStatus &)
IMPORT_C TInt Connect ()
IMPORT_C void Install (const TDesC8 &, TDes8 &, TRequestStatus &)
IMPORT_C void Uninstall (const TDesC8 &, TDes8 &, TRequestStatus &)
Inherited Functions
RHandleBase::Attributes()const
RHandleBase::BTraceId()const
RHandleBase::Close()
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
RHandleBase:TAttributes
RSessionBase:TAttachMode
Inherited Attributes
RHandleBase::iHandle

Member Functions Documentation

BufferReallocated(TDes8 &, TRequestStatus &)

IMPORT_C void BufferReallocated ( TDes8 & aDialogBuffer,
TRequestStatus & aRequestStatus
)

If a dialog request has been received from swis which does not fit in the client request then the client should re-issue the request with a bigger buffer using this function.

Parameters

TDes8 & aDialogBuffer
TRequestStatus & aRequestStatus

Cancel()

IMPORT_C TInt Cancel ( )

Cancel current activity of SWIS. This is meaningful during file installation phase only because to cancel installation planning it is only necessary to cancel a dialog box.

CompleteDialog(TInt, TDes8 &, TRequestStatus &)

IMPORT_C void CompleteDialog ( TInt aError,
TDes8 & aDialogBuffer,
TRequestStatus & aRequestStatus
)

Issue a dialog request, which will complete with either dialog callback information or the final status of the current operation.

Parameters

TInt aError
TDes8 & aDialogBuffer
TRequestStatus & aRequestStatus

Connect()

IMPORT_C TInt Connect ( )

Connect to the server. Assumes the server is already running, because it is started from SISHelper and runs in the same process, and this class is used by SWIS. Starting a server requires linking against the module containing UISS thread function, and SWIS cannot do that because it is TCB and UISS is not, nor is SISHelper. So the result is that UISSClient module may not contain UISS thread function or any function that starts UISS.

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

IMPORT_C void Install ( const TDesC8 & aParams,
TDes8 & aDialogBuffer,
TRequestStatus & aRequestStatus
)

Start asynchronous installation.

Note that the caller is responsible for making sure that the parameters persist accross the duration of the servicing of the request.

Parameters

const TDesC8 & aParams
TDes8 & aDialogBuffer Response buffer for dialogue to invoke information.
TRequestStatus & aRequestStatus

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

IMPORT_C void Uninstall ( const TDesC8 & aParams,
TDes8 & aDialogBuffer,
TRequestStatus & aRequestStatus
)

Start asynchronous uninstallation

Note that the caller is responsible for making sure that the parameters persist accross the duration of the servicing of the request.

Parameters

const TDesC8 & aParams
TDes8 & aDialogBuffer Response buffer for dialogue to invoke information.
TRequestStatus & aRequestStatus