CSIPConnection Class Reference

#include <mw/sipconnection.h>

class CSIPConnection : public CBase

Inherits from

CSIPConnection
- CBase

Public Member Enumerations
enum	TState { EInit, EActive, ESuspended, EInactive, EUnavailable }

Public Member Functions
	~CSIPConnection()
IMPORT_C CSIPClientTransaction *	FetchRegistrationsL(CSIPRequestElements *)
IMPORT_C void	GetConnectionErrorL(TInt &)
IMPORT_C void	GetLocalAddrL(TInetAddr &)
IMPORT_C TUint32	IapId()
CSIPConnectionImplementation &	Implementation()
IMPORT_C CSIPConnection *	NewL(CSIP &, TUint32, MSIPConnectionObserver &)
IMPORT_C CSIPConnection *	NewLC(CSIP &, TUint32, MSIPConnectionObserver &)
IMPORT_C void	RefreshConnection()
IMPORT_C CSIP *	SIP()
IMPORT_C const CSIP *	SIP()
IMPORT_C CSIPClientTransaction *	SendRequestL(CSIPRequestElements *, const MSIPRegistrationContext &)
IMPORT_C CSIPClientTransaction *	SendRequestL(CSIPRequestElements *, const MSIPRegistrationContext &, CSIPRefresh &)
IMPORT_C CSIPClientTransaction *	SendRequestL(CSIPRequestElements *)
IMPORT_C CSIPClientTransaction *	SendRequestL(CSIPRequestElements *, CSIPRefresh &)
IMPORT_C void	SetOptL(TUint, TUint, const TDesC8 &)
IMPORT_C void	SetOptL(TUint, TUint, TInt)
IMPORT_C TState	State()

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()

Detailed Description

Class for monitoring connection's state and sending SIP requests outside the dialog associations. Class must not be used

for sending requests to which received non-failure response creates a dialog
for sending requests that must be sent within SIP dialog

Note that the user can have only one instance of the class per same IAP-id.

Member Enumeration Documentation

Enum TState

Connection states

Enumerator	Value	Description
EInit	1	Connection initializing
EActive		Connection active
ESuspended		Connection suspended
EInactive		Connection is inactive
EUnavailable		Connection is permanently unavailable

Constructor & Destructor Documentation

~CSIPConnection ( )

IMPORT_C

~CSIPConnection

(

)

Destructor

Capability
NetworkServices

Member Function Documentation

FetchRegistrationsL ( CSIPRequestElements * )

IMPORT_C CSIPClientTransaction *

FetchRegistrationsL

(

CSIPRequestElements *

aElements

)

Creates SIP REGISTER request and sends it to the given destination. User must no define any Contact or Expires-headers in the provided elements.

Pre-condition: State() == EActive
aElements != 0 aElements->Method().DesC().Length()==0

Parameters
aElements	contains local and remote addresses, optional SIP message headers and body. User must not set any expires values to aElements. The ownership is transferred.

Return Value: SIP REGISTER client transaction, ownership is transferred

Leave Codes
KErrArgument	if aElements == 0 or if the request method has been defined in aElements

Capability
NetworkServices

GetConnectionErrorL ( TInt & )

IMPORT_C void

GetConnectionErrorL

(

TInt &

aError

)

const

Gets the connection error code

Parameters
aError	will be filled with the error code

Leave Codes
a	system-wide error code

Capability
NetworkServices.

GetLocalAddrL ( TInetAddr & )

IMPORT_C void

GetLocalAddrL

(

TInetAddr &

aAddr

)

const

Gets the local IP address of this CSIPConnection that is used by the SIP implementation. The user should re-new the call whenever the connection state changes to the CSIPConnection::EActive in order to verify the correctness of the previously retrieved local IP address. The local IP address might be different as a result of the connection state change.

Pre-condition: State() == CSIPConnection::EActive

Parameters
aAddr	on return filled with local IP address

Leave Codes
a	system-wide error code

IapId ( )

IMPORT_C TUint32

IapId

(

)

const

Gets Iap-id used for this connection

Return Value: Iap-id

Implementation ( )

CSIPConnectionImplementation &

Implementation

(

)

Returns the implementation instance.

Return Value: CSIPConnectionImplementation

NewL ( CSIP &, TUint32, MSIPConnectionObserver & )

IMPORT_C CSIPConnection *	NewL	(	CSIP &	aSIP,
			TUint32	aIapId,
			MSIPConnectionObserver &	aObserver
		)	[static]

Two-phased constructor.

Parameters
aIapId	IAP-id
aObserver	a observer for receiving asynchonous events on this connection

Return Value: New object, ownership is transferred

Capability
NetworkServices

NewLC ( CSIP &, TUint32, MSIPConnectionObserver & )

IMPORT_C CSIPConnection *	NewLC	(	CSIP &	aSIP,
			TUint32	aIapId,
			MSIPConnectionObserver &	aObserver
		)	[static]

Two-phased constructor. Constructs an object and adds the pointer to the cleanup stack;

Parameters
aIapId	IAP-id
aObserver	a observer for receiving asynchonous events on this connection

Return Value: New object, ownership is transferred

Capability
NetworkServices

RefreshConnection ( )

IMPORT_C void

RefreshConnection

(

)

const

Refreshes the connection. This will retrieve the Bearer Monitor Instance if any, is available for this CSIPConnection and issue a Connection Refresh Request to it. The state of the Connection can be retrieved from State() to check if there is any change after Refreshing the connection.

Capability
NetworkServices.

SIP ( )

IMPORT_C CSIP *

SIP

(

)

Gets SIP server handle

Return Value: handle to SIP server, or 0-pointer if SIP server does not exist any more

SIP ( )

IMPORT_C const CSIP *

SIP

(

)

const

Gets SIP server handle

Return Value: handle to SIP server, or 0-pointer if SIP server does not exist any more

SendRequestL ( CSIPRequestElements *, const MSIPRegistrationContext & )

IMPORT_C CSIPClientTransaction *	SendRequestL	(	CSIPRequestElements *	aElements,
			const MSIPRegistrationContext &	aContext
		)

Creates SIP request and sends it to the given destination. The function must not be used with SIP requests that creates SIP dialog associations or must be sent within SIP dialog association. This provokes the Non-invite state machine. This function must be used if the user has created the registration binding.

Pre-condition: State() == EActive.
aContext.IsContextActive() == ETrue

Parameters
aElements	contains local and remote addresses, optional SIP message headers and body. The ownership is transferred.
aContext	defines outbound proxy to be used. If the user does not provide from-address it will be constucted using user's AOR used during the registration.

Return Value: SIP client transaction, ownership is transferred

Leave Codes
KErrArgument	if aElements == 0
KErrSIPInvalidRegistrationState	if aContext.IsContextActive() == EFalse

Capability
NetworkServices

SendRequestL ( CSIPRequestElements *, const MSIPRegistrationContext &, CSIPRefresh & )

IMPORT_C CSIPClientTransaction *	SendRequestL	(	CSIPRequestElements *	aElements,
			const MSIPRegistrationContext &	aContext,
			CSIPRefresh &	aRefresh
		)

Pre-condition: State() == EActive.
aContext.IsContextActive() == ETrue

Parameters
aElements	contains local and remote addresses, optional SIP message headers and body. The ownership is transferred.
aContext	defines outbound proxy to be used. If the user does not provide from-address it will be constucted using user's AOR used during the registration.
aRefresh	defines the refresh interval for this transaction.

Return Value: SIP client transaction, ownership is transferred

Leave Codes
KErrArgument	if aElements == 0
KErrSIPInvalidRegistrationState	if aContext.IsContextActive() == EFalse

Capability
NetworkServices

SendRequestL ( CSIPRequestElements * )

IMPORT_C CSIPClientTransaction *

SendRequestL

(

CSIPRequestElements *

aElements

)

Pre-condition: State() == EActive.
aElements.FromHeader() != 0

Parameters
aElements	contains local and remote addresses, optional SIP message headers and body. The ownership is transferred.

Return Value: SIP client transaction, ownership is transferred

Leave Codes
KErrArgument	if aElements == 0 or if From-header is not present in aElements

Capability
NetworkServices

SendRequestL ( CSIPRequestElements *, CSIPRefresh & )

IMPORT_C CSIPClientTransaction *	SendRequestL	(	CSIPRequestElements *	aElements,
			CSIPRefresh &	aRefresh
		)

Pre-condition: State() == EActive.
aElements.FromHeader() != 0

Parameters
aElements	contains local and remote addresses, optional SIP message headers and body. The ownership is transferred.
aRefresh	indicates that transaction will be refreshed

Return Value: SIP client transaction, ownership is transferred

Leave Codes
KErrArgument	if aElements == 0 or if From-header is not present in aElements

Capability
NetworkServices

SetOptL ( TUint, TUint, const TDesC8 & )

IMPORT_C void	SetOptL	(	TUint	aOptionName,
			TUint	aOptionLevel,
			const TDesC8 &	aOption = KNullDesC8
		)

Sets a RSocket option used for all the sockets used for sending SIP requests and responses in this CSIPConnection.

Pre-condition: State() == EActive

Parameters
aOptionName	An integer constant which identifies an option.
aOptionLevel	An integer constant which identifies level of an option.
aOption	Option value packaged in a descriptor.

Leave Codes
A	system-wide error code

Capability
NetworkControl
NetworkServices
Location
ReadDeviceData
WriteDeviceData

SetOptL ( TUint, TUint, TInt )

IMPORT_C void	SetOptL	(	TUint	aOptionName,
			TUint	aOptionLevel,
			TInt	aOption
		)

Sets a RSocket option used for all the sockets used for sending SIP requests and responses in this CSIPConnection.

Pre-condition: State() == EActive

Parameters
aOptionName	An integer constant which identifies an option.
aOptionLevel	An integer constant which identifies level of an option.
aOption	Option value as an integer.

Leave Codes
A	system-wide error codes

Capability
NetworkControl
NetworkServices
Location
ReadDeviceData
WriteDeviceData

State ( )

IMPORT_C TState

State

(

)

const

Gets current state of the connection

Return Value: current state of the connection