RConnectionMonitor Class Reference

class RConnectionMonitor : public RSessionBase

Inherits from

Public Member Functions
RConnectionMonitor ()
IMPORT_C void CancelAsyncRequest ( TInt )
IMPORT_C void CancelNotifications ()
IMPORT_C void Close ()
IMPORT_C TInt ConnectL ()
IMPORT_C void GetBoolAttribute (const TUint , const TUint , const TUint , TBool &, TRequestStatus &)
IMPORT_C void GetConnectionCount ( TUint &, TRequestStatus &)
IMPORT_C TInt GetConnectionInfo (const TUint , TUint &, TUint &)
IMPORT_C void GetIntAttribute (const TUint , const TUint , const TUint , TInt &, TRequestStatus &)
IMPORT_C void GetPckgAttribute (const TUint , const TUint , const TUint , TDes8 &, TRequestStatus &)
IMPORT_C void GetPckgAttribute (const TUint , const TUint , const TUint , TDes16 &, TRequestStatus &)
IMPORT_C void GetStringAttribute (const TUint , const TUint , const TUint , TDes &, TRequestStatus &)
IMPORT_C TInt GetSubConnectionInfo (const TUint , const TUint , TUint &)
IMPORT_C void GetUintAttribute (const TUint , const TUint , const TUint , TUint &, TRequestStatus &)
IMPORT_C TInt NotifyEventL ( MConnectionMonitorObserver &)
IMPORT_C TInt SetBoolAttribute (const TUint , const TUint , const TUint , const TBool )
IMPORT_C TInt SetIntAttribute (const TUint , const TUint , const TUint , const TInt )
IMPORT_C TInt SetPckgAttribute (const TUint , const TUint , const TUint , const TDes8 &)
IMPORT_C TInt SetStringAttribute (const TUint , const TUint , const TUint , const TDes &)
IMPORT_C TInt SetUintAttribute (const TUint , const TUint , const TUint , const TUint )
Private Member Functions
void CancelReceiveEvent ()
TBool IsConnected ()
TPtr8 & NextPtr ()
void ReceiveEvent ( TDes8 &, TDes8 &, 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
CConnMonEventHandler * iHandler
TInt iIndex
RArray < TPtr8 > iPtrArray
Inherited Attributes
RHandleBase::iHandle

Constructor & Destructor Documentation

RConnectionMonitor()

RConnectionMonitor ( ) [inline]

Constructor.

Member Functions Documentation

CancelAsyncRequest(TInt)

IMPORT_C void CancelAsyncRequest ( TInt aReqToCancel )

Cancels an asyncronous request. If there is several active requests of the same type (for example GetIntAttribute), they will all be cancelled. When a request is cancelled, it is completed with error code KErrCancel.

Parameters

TInt aReqToCancel Identifies the request type to be cancelled. The different types are defined in TConnMonAsyncRequest.

CancelNotifications()

IMPORT_C void CancelNotifications ( )

Cancels the notifications from connection monitor.

CancelReceiveEvent()

void CancelReceiveEvent ( ) [private]

Close()

IMPORT_C void Close ( )

Closes the Connection Monitor session. An opened RConnectionMonitor must be closed explicitily to prevent a resource (memory) leak.

ConnectL()

IMPORT_C TInt ConnectL ( )

Connects the client to the Connection Monitor Server. It must be called before any of other methods during the Connection Monitor session.

GetBoolAttribute(const TUint, const TUint, const TUint, TBool &, TRequestStatus &)

IMPORT_C void GetBoolAttribute ( const TUint aConnectionId,
const TUint aSubConnectionId,
const TUint aAttribute,
TBool & aValue,
TRequestStatus & aStatus
)

Gets the value for a TBool attribute.

Parameters

const TUint aConnectionId Connection ID.
const TUint aSubConnectionId Subconnection ID. If set to 0, method applies to connection.
const TUint aAttribute Identifies the attribute to be retrieved.
TBool & aValue On completion, contains the requested TBool attribute.
TRequestStatus & aStatus KErrNone if successful, a system-wide error code if not.

GetConnectionCount(TUint &, TRequestStatus &)

IMPORT_C void GetConnectionCount ( TUint & aConnectionCount,
TRequestStatus & aStatus
)

Gathers information on currently active connections.

Parameters

TUint & aConnectionCount On completion, contains the number of active connections.
TRequestStatus & aStatus KErrNone if successful, a system-wide error code if not.

GetConnectionInfo(const TUint, TUint &, TUint &)

IMPORT_C TInt GetConnectionInfo ( const TUint aIndex,
TUint & aConnectionId,
TUint & aSubConnectionCount
) const

Gets the connection ID and the count of the subconnections for the given index. GetConnectionCount() must be called to gather the information on active connections before calling this method.

Parameters

const TUint aIndex Must be between 1 and the count returned by GetConnectionCount().
TUint & aConnectionId On return, contains the connection ID.
TUint & aSubConnectionCount On return, contains the number of subconnections.

GetIntAttribute(const TUint, const TUint, const TUint, TInt &, TRequestStatus &)

IMPORT_C void GetIntAttribute ( const TUint aConnectionId,
const TUint aSubConnectionId,
const TUint aAttribute,
TInt & aValue,
TRequestStatus & aStatus
)

Gets the value for a TInt attribute.

Parameters

const TUint aConnectionId Connection ID.
const TUint aSubConnectionId Subconnection ID. If set to 0, method applies to connection.
const TUint aAttribute Identifies the attribute to be retrieved.
TInt & aValue On completion, contains the requested TInt attribute.
TRequestStatus & aStatus KErrNone if successful, a system-wide error code if not.

GetPckgAttribute(const TUint, const TUint, const TUint, TDes8 &, TRequestStatus &)

IMPORT_C void GetPckgAttribute ( const TUint aConnectionId,
const TUint aSubConnectionId,
const TUint aAttribute,
TDes8 & aValue,
TRequestStatus & aStatus
) const

Gets the value for a packaged attribute.

Parameters

const TUint aConnectionId Connection ID.
const TUint aSubConnectionId Subconnection ID. If set to 0, method applies to connection.
const TUint aAttribute Identifies the attribute to be retrieved.
TDes8 & aValue On completion, contains the requested packaged attribute.
TRequestStatus & aStatus KErrNone if successful, a system-wide error code if not.

GetPckgAttribute(const TUint, const TUint, const TUint, TDes16 &, TRequestStatus &)

IMPORT_C void GetPckgAttribute ( const TUint aConnectionId,
const TUint aSubConnectionId,
const TUint aAttribute,
TDes16 & aValue,
TRequestStatus & aStatus
) const

Gets the value for a packaged attribute.

Parameters

const TUint aConnectionId Connection ID.
const TUint aSubConnectionId Subconnection ID. If set to 0, method applies to connection.
const TUint aAttribute Identifies the attribute to be retrieved.
TDes16 & aValue On completion, contains the requested packaged attribute.
TRequestStatus & aStatus KErrNone if successful, a system-wide error code if not.

GetStringAttribute(const TUint, const TUint, const TUint, TDes &, TRequestStatus &)

IMPORT_C void GetStringAttribute ( const TUint aConnectionId,
const TUint aSubConnectionId,
const TUint aAttribute,
TDes & aValue,
TRequestStatus & aStatus
) const

Gets the value for a string attribute.

Parameters

const TUint aConnectionId Connection ID.
const TUint aSubConnectionId Subconnection ID. If set to 0, method applies to connection.
const TUint aAttribute Identifies the attribute to be retrieved.
TDes & aValue On completion, contains the requested string. Use a 16-bit descriptor!
TRequestStatus & aStatus KErrNone if successful, a system-wide error code if not.

GetSubConnectionInfo(const TUint, const TUint, TUint &)

IMPORT_C TInt GetSubConnectionInfo ( const TUint aConnectionId,
const TUint aIndex,
TUint & aSubConnectionId
) const

Gets the subconnection ID for the given index.

Parameters

const TUint aConnectionId Connection ID.
const TUint aIndex Must be between 1 and the subconnection count returned by GetConnectionInfo().
TUint & aSubConnectionId On return, contains the subconnection ID.

GetUintAttribute(const TUint, const TUint, const TUint, TUint &, TRequestStatus &)

IMPORT_C void GetUintAttribute ( const TUint aConnectionId,
const TUint aSubConnectionId,
const TUint aAttribute,
TUint & aValue,
TRequestStatus & aStatus
)

Gets the value for a TUint attribute.

Parameters

const TUint aConnectionId Connection ID.
const TUint aSubConnectionId Subconnection ID. If set to 0, method applies to connection.
const TUint aAttribute Identifies the attribute to be retrieved.
TUint & aValue On completion, contains the requested TUint attribute.
TRequestStatus & aStatus KErrNone if successful, a system-wide error code if not.

IsConnected()

TBool IsConnected ( ) const [private]

NextPtr()

TPtr8 & NextPtr ( ) [private]

NotifyEventL(MConnectionMonitorObserver &)

IMPORT_C TInt NotifyEventL ( MConnectionMonitorObserver & aObserver )

Registers an event observer to catch connection monitor events.

Parameters

MConnectionMonitorObserver & aObserver The event observer.

ReceiveEvent(TDes8 &, TDes8 &, TRequestStatus &)

void ReceiveEvent ( TDes8 & aBuffer,
TDes8 & aExtraBuf,
TRequestStatus & aStatus
) [private]

Parameters

TDes8 & aBuffer
TDes8 & aExtraBuf
TRequestStatus & aStatus

SetBoolAttribute(const TUint, const TUint, const TUint, const TBool)

IMPORT_C TInt SetBoolAttribute ( const TUint aConnectionId,
const TUint aSubConnectionId,
const TUint aAttribute,
const TBool aValue
) const

Sets the value for a TBool attribute.

This method can be used to stop a connection (KConnectionStop).

Parameters

const TUint aConnectionId Connection ID.
const TUint aSubConnectionId Subconnection ID. If set to 0, method applies to connection.
const TUint aAttribute Identifies the attribute to be set.
const TBool aValue The value to be set.

SetIntAttribute(const TUint, const TUint, const TUint, const TInt)

IMPORT_C TInt SetIntAttribute ( const TUint aConnectionId,
const TUint aSubConnectionId,
const TUint aAttribute,
const TInt aValue
) const

Sets the value for a TInt attribute.

Parameters

const TUint aConnectionId Connection ID.
const TUint aSubConnectionId Subconnection ID. If set to 0, method applies to connection.
const TUint aAttribute Identifies the attribute to be set.
const TInt aValue The value to be set.

SetPckgAttribute(const TUint, const TUint, const TUint, const TDes8 &)

IMPORT_C TInt SetPckgAttribute ( const TUint aConnectionId,
const TUint aSubConnectionId,
const TUint aAttribute,
const TDes8 & aValue
) const

Sets the value for a packaged attribute. There is currently no packaged attributes that can be set.

Parameters

const TUint aConnectionId Connection ID.
const TUint aSubConnectionId Subconnection ID. If set to 0, method applies to connection.
const TUint aAttribute Identifies the attribute to be set.
const TDes8 & aValue The value to be set.

SetStringAttribute(const TUint, const TUint, const TUint, const TDes &)

IMPORT_C TInt SetStringAttribute ( const TUint aConnectionId,
const TUint aSubConnectionId,
const TUint aAttribute,
const TDes & aValue
) const

Sets the value for a string attribute.

Parameters

const TUint aConnectionId Connection ID.
const TUint aSubConnectionId Subconnection ID. If set to 0, method applies to connection.
const TUint aAttribute Identifies the attribute to be set.
const TDes & aValue The string value to be set. Must be a 16-bit descriptor.

SetUintAttribute(const TUint, const TUint, const TUint, const TUint)

IMPORT_C TInt SetUintAttribute ( const TUint aConnectionId,
const TUint aSubConnectionId,
const TUint aAttribute,
const TUint aValue
) const

Sets the value for a TUint attribute.

Parameters

const TUint aConnectionId Connection ID.
const TUint aSubConnectionId Subconnection ID. If set to 0, method applies to connection.
const TUint aAttribute Identifies the attribute to be set.
const TUint aValue The value to be set.

Member Data Documentation

CConnMonEventHandler * iHandler

CConnMonEventHandler * iHandler [private]

TInt iIndex

TInt iIndex [private]

RArray< TPtr8 > iPtrArray

RArray < TPtr8 > iPtrArray [private]