Collapse all Symbian^3 Product Developer Library

RConnectionUiUtilitiesSession Class Reference

class RConnectionUiUtilitiesSession : public RSessionBase

Inherits from

RConnectionUiUtilitiesSession
- RSessionBase
  - RHandleBase

Public Member Functions
	RConnectionUiUtilitiesSession()
	~RConnectionUiUtilitiesSession()
void	CancelChangingConnectionToNote()
void	CancelConfirmMethodUsageQuery()
void	CancelConnectedViaConnMethodNote()
void	CancelConnectedViaDestAndConnMethodNote()
void	CancelConnectingViaDiscreetPopup()
void	CancelConnectionErrorDiscreetPopup()
void	CancelEasyWapiDlg()
void	CancelEasyWepDlg()
void	CancelEasyWpaDlg()
void	CancelOffLineWlanNote()
void	CancelSearchWLANNetwork()
void	ChangingConnectionToNote(const TUint32, TRequestStatus &)
void	Close()
void	ConfirmMethodUsageQuery(TMsgQueryLinkedResults &, const TBool, TRequestStatus &)
TInt	Connect()
void	ConnectedViaConnMethodNote(const TUint32, TRequestStatus &)
void	ConnectedViaDestAndConnMethodNote(const TUint32, const TUint32, TRequestStatus &)
void	ConnectingViaDiscreetPopup(TPckgBuf< TConnUiConnectingViaDiscreetPopup > &, TRequestStatus &)
void	ConnectionErrorDiscreetPopup(TPckgBuf< TInt > &, TRequestStatus &)
void	EasyWapiDlg(TPckgBuf< TBuf< KEasyWapiQueryMaxLength > > &, TRequestStatus &)
void	EasyWepDlg(TPckgBuf< TWepKeyData > &, TRequestStatus &)
void	EasyWpaDlg(TPckgBuf< TBuf< KEasyWpaQueryMaxLength > > &, TRequestStatus &)
void	NoWLANNetworksAvailableNote(TRequestStatus &)
void	OffLineWlanDisabledNote(TRequestStatus &)
void	OffLineWlanNote(TRequestStatus &, TBool)
void	SearchWLANNetwork(TPckgBuf< TConnUiUiWlanNetworkPrefs > &, TRequestStatus &, TBool)
void	WLANNetworkUnavailableNote(TRequestStatus &)

Inherited Functions
	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
	RHandleBase:TAttributes
	RSessionBase:TAttachMode

Private Attributes
TPckg< TBool >	iBool
RNotifier *	iNotifier
TPckgBuf< TConnUiUiDestConnMethodNoteId >	iPassedInfo
TPckg< TMsgQueryLinkedResults >	iResponseMsgQuery
TBuf8< 8 >	iResponseStrConnectingNote
TBuf8< 8 >	iResponseStrNoWLANNetworksAvailableNote
TBuf8< 8 >	iResponseStrOffLineWlanDisabledNote
TBuf8< 8 >	iResponseStrOffLineWlanNote
TBuf8< 8 >	iResponseStrWLANNetworkUnavailableNote

Inherited Attributes
	RHandleBase::iHandle

Constructor & Destructor Documentation

RConnectionUiUtilitiesSession()

RConnectionUiUtilitiesSession

(

)

Constructor.

~RConnectionUiUtilitiesSession()

~RConnectionUiUtilitiesSession

(

)

Destructor.

Member Functions Documentation

CancelChangingConnectionToNote()

void

CancelChangingConnectionToNote

(

)

Cancel ChangingConnectionToNote notifier.

CancelConfirmMethodUsageQuery()

void

CancelConfirmMethodUsageQuery

(

)

Cancel ConfirmMethodUsageQuery

CancelConnectedViaConnMethodNote()

void

CancelConnectedViaConnMethodNote

(

)

Cancel ConnectedViaConnMethodNote notifier.

CancelConnectedViaDestAndConnMethodNote()

void

CancelConnectedViaDestAndConnMethodNote

(

)

Cancel ConnectedViaDestAndConnMethodNote notifier.

CancelConnectingViaDiscreetPopup()

void

CancelConnectingViaDiscreetPopup

(

)

Cancel ConnectingViaDiscreetPopup notifier.

CancelConnectionErrorDiscreetPopup()

void

CancelConnectionErrorDiscreetPopup

(

)

Cancel ConnectionErrorDiscreetPopup notifier.

CancelEasyWapiDlg()

void

CancelEasyWapiDlg

(

)

Cancel EasyWapiDlg notifier.

CancelEasyWepDlg()

void

CancelEasyWepDlg

(

)

Cancel Easy Wep dialog

CancelEasyWpaDlg()

void

CancelEasyWpaDlg

(

)

Cancel Easy Wpa dialog

CancelOffLineWlanNote()

void

CancelOffLineWlanNote

(

)

Cancel OffLineWlan Note

CancelSearchWLANNetwork()

void

CancelSearchWLANNetwork

(

)

Cancel SearchWLANNetwork

ChangingConnectionToNote(const TUint32, TRequestStatus &)

void	ChangingConnectionToNote	(	const TUint32	aConnMId,
			TRequestStatus &	aStatus
		)

Information note is used when "Automatically" roaming is enabled The actual connection establishment take places in the background (no wait note).

Parameters

const TUint32 aConnMId	Id of used connection method.
TRequestStatus & aStatus	Status object of notifier.

Close()

void

(

)

Disconnect from the notifier server.

ConfirmMethodUsageQuery(TMsgQueryLinkedResults &, const TBool, TRequestStatus &)

void	ConfirmMethodUsageQuery	(	TMsgQueryLinkedResults &	aResult,
			const TBool	aHomeNetwork,
			TRequestStatus &	aStatus
		)

Notifier. Shows a query, "Connect to\n '%0U' via\n '%1U'?"

Parameters

TMsgQueryLinkedResults & aResult	Result of user selection, ETrue if user accepted roaming, to more preferred method, EFlase otherwise
const TBool aHomeNetwork	home or foreign network
TRequestStatus & aStatus	Status object of notifier.

Connect()

TInt

Connect

(

)

Connect to the notifier server. Must be called before any other function (c'tor excepted).

ConnectedViaConnMethodNote(const TUint32, TRequestStatus &)

void	ConnectedViaConnMethodNote	(	const TUint32	aConnMId,
			TRequestStatus &	aStatus
		)

Confirmation note is used after the connection has been successfully established via a connection method.

Parameters

const TUint32 aConnMId	Id of used connection method.
TRequestStatus & aStatus	Status object of notifier.

ConnectedViaDestAndConnMethodNote(const TUint32, const TUint32, TRequestStatus &)

void	ConnectedViaDestAndConnMethodNote	(	const TUint32	aDestId,
			const TUint32	aConnMId,
			TRequestStatus &	aStatus
		)

Confirmation note is used after the connection has been successfully established via destination and connection method.

Parameters

const TUint32 aDestId	Id of used destination.
const TUint32 aConnMId	Id of used connection method.
TRequestStatus & aStatus	Status object of notifier.

ConnectingViaDiscreetPopup(TPckgBuf< TConnUiConnectingViaDiscreetPopup > &, TRequestStatus &)

void	ConnectingViaDiscreetPopup	(	TPckgBuf< TConnUiConnectingViaDiscreetPopup > &	aInfo,
			TRequestStatus &	aStatus
		)

Discreet popup. Shows "connecting via %U" discreet popup.

Parameters

TPckgBuf< TConnUiConnectingViaDiscreetPopup > & aInfo	Information about bearer.
TRequestStatus & aStatus

ConnectionErrorDiscreetPopup(TPckgBuf< TInt > &, TRequestStatus &)

void	ConnectionErrorDiscreetPopup	(	TPckgBuf< TInt > &	aErrCode,
			TRequestStatus &	aStatus
		)

Discreet popup. Shows discreet popup about connection error.

Parameters

TPckgBuf< TInt > & aErrCode	Error code.
TRequestStatus & aStatus

EasyWapiDlg(TPckgBuf< TBuf< KEasyWapiQueryMaxLength > > &, TRequestStatus &)

void	EasyWapiDlg	(	TPckgBuf< TBuf< KEasyWapiQueryMaxLength > > &	aKey,
			TRequestStatus &	aStatus
		)

Notifier. Prompts WAPI-PSK. Shows a data query, "Enter pre-shared key for WLAN"

Parameters

TPckgBuf< TBuf< KEasyWapiQueryMaxLength > > & aKey	Key entered by user
TRequestStatus & aStatus

EasyWepDlg(TPckgBuf< TWepKeyData > &, TRequestStatus &)

void	EasyWepDlg	(	TPckgBuf< TWepKeyData > &	aKey,
			TRequestStatus &	aStatus
		)

Notifier. Shows a data query, "Enter WEP key for WLAN"

Parameters

TPckgBuf< TWepKeyData > & aKey	Key entered by user
TRequestStatus & aStatus

EasyWpaDlg(TPckgBuf< TBuf< KEasyWpaQueryMaxLength > > &, TRequestStatus &)

void	EasyWpaDlg	(	TPckgBuf< TBuf< KEasyWpaQueryMaxLength > > &	aKey,
			TRequestStatus &	aStatus
		)

Notifier. Shows a data query, "Enter pre-shared key for WLAN"

Parameters

TPckgBuf< TBuf< KEasyWpaQueryMaxLength > > & aKey	Key entered by user
TRequestStatus & aStatus

NoWLANNetworksAvailableNote(TRequestStatus &)

void

NoWLANNetworksAvailableNote

(

TRequestStatus &

aStatus

)

Pops up an information note: "No WLAN networks are available at the moment. Connection not available."

Parameters

TRequestStatus & aStatus

OffLineWlanDisabledNote(TRequestStatus &)

void

OffLineWlanDisabledNote

(

TRequestStatus &

aStatus

)

Notifier. Pops up an information note: "Operation not possible in Off-line mode"

Parameters

TRequestStatus & aStatus

OffLineWlanNote(TRequestStatus &, TBool)

void	OffLineWlanNote	(	TRequestStatus &	aStatus,
			TBool	aIsAsyncVersion
		)

Notifier. Shows a query, "Do you want to create a WLAN connection in Off-line mode?"

Parameters

TRequestStatus & aStatus	status object of notifier
TBool aIsAsyncVersion	ETrue if called by a really asynchronous function

SearchWLANNetwork(TPckgBuf< TConnUiUiWlanNetworkPrefs > &, TRequestStatus &, TBool)

void	SearchWLANNetwork	(	TPckgBuf< TConnUiUiWlanNetworkPrefs > &	aNetworkPrefs,
			TRequestStatus &	aStatus,
			TBool	aIsAsyncVersion
		)

Notifier. Search available WLAN networks, and user can select one of them

Parameters

TPckgBuf< TConnUiUiWlanNetworkPrefs > & aNetworkPrefs	Return parameter, contains id, connection mode and security mode of selected wlan network
TRequestStatus & aStatus	status object of notifier or user does not select a network.
TBool aIsAsyncVersion	ETrue if called by a really asynchronous function

WLANNetworkUnavailableNote(TRequestStatus &)

void

WLANNetworkUnavailableNote

(

TRequestStatus &

aStatus

)

Pops up an information note: "Selected WLAN network has no coverage"

Parameters

TRequestStatus & aStatus

Member Data Documentation

TPckg< TBool > iBool

TPckg< TBool >

iBool

[private]

RNotifier * iNotifier

RNotifier *

iNotifier

[private]

TPckgBuf< TConnUiUiDestConnMethodNoteId > iPassedInfo

TPckgBuf< TConnUiUiDestConnMethodNoteId >

iPassedInfo

[private]

TPckg< TMsgQueryLinkedResults > iResponseMsgQuery

TPckg< TMsgQueryLinkedResults >

iResponseMsgQuery

[private]

TBuf8< 8 > iResponseStrConnectingNote

TBuf8< 8 >

iResponseStrConnectingNote

[private]

TBuf8< 8 > iResponseStrNoWLANNetworksAvailableNote

TBuf8< 8 >

iResponseStrNoWLANNetworksAvailableNote

[private]

TBuf8< 8 > iResponseStrOffLineWlanDisabledNote

TBuf8< 8 >

iResponseStrOffLineWlanDisabledNote

[private]

TBuf8< 8 > iResponseStrOffLineWlanNote

TBuf8< 8 >

iResponseStrOffLineWlanNote

[private]

TBuf8< 8 > iResponseStrWLANNetworkUnavailableNote

TBuf8< 8 >

iResponseStrWLANNetworkUnavailableNote

[private]