Connection Management Interface

Empty constructor.

Empty destructor.

Requests asynchronous change notification for all interfaces.

This allows a client to receive a notification whenever a connection in the system goes up or down.

This allows the automatic update of the list of active network connections.

Requests notification of any change in the state of any of the subconnections belonging to this RConnection .

Attaches the RConnection object to an existing interface.

This operation will not start an interface, as Start() does, but attaches to an existing interface if it exists.

Cancels a change notification request previously issued by a call to AllInterfaceNotification() .

Cancels the request for notification to changes to the state of subconnections, made using the AllSubConnectionNotification() .

Cancel any outstanding Ioctl request

Cancels a request for progress notification for the connection, as issued by ProgressNotification() .

Cancels a request for progress notification for a specified subconnection, as issued by ProgressNotification() .

Cancels a request for notification of change of service for the connection, as issued by ServiceChangeNotification() . Nothing happens if called without having called "RConnection::ServiceChangeNotification(...)" before. Important: It Panics if used BEFORE "RConnecion::Open(...)" being called.

Cancel the previous subscription for an incoming session.

Closes the connection.

The connection will not be dropped immediately: it will be dropped when there is no more data traffic on the connection. So if a client needs to graciously shutdown the connection, Close() , not Stop() , needs to be used after shutting down the socket.

Gets detailed information on connection clients and sockets.

More likely to be used by system control type applications.

Cancels a request (issued by DataReceivedNotificationRequest ()) for the amount of data received by the entire connection.

Cancels a request (issued by DataReceivedNotificationRequest ()) for the amount of data received by the specified subconnection.

Requests a notification after an additional aThreshold bytes have been received by this connection.

Completes when an amount of data equal to aThreshold has been received, starting from when the request is posted.

Making this request with an aThreshold of zero will result in the server reading the value in aDownlinkVolume, and producing a notification when the absolute amount of data specified here has been sent.

Requests notification after an additional aThreshold bytes have been received by a specified subconnection.

Completes when an amount of data equal to aThreshold has been received, starting from when the request is posted.

Making this request with an aThreshold of zero will result in the server reading the value in aDownlinkVolume, and producing a notification when the absolute amount of data specified here has been sent.

Cancels a request for the amount of data sent on this connection, as issued by DataSentNotificationRequest() .

Cancels a request for the amount of data sent by the specified subconnection.

Requests a notification after an additional aThreshold bytes have been sent by the entire connection.

Making this request with an aThreshold of zero will result in the server reading the value in aUplinkVolume and producing a notification when the absolute amount of data specified here has been sent.

Requests a notification after an additional aThreshold bytes have been sent on a specified subconnection.

Making this request with an aThreshold of zero will result in the server reading the value in aUplinkVolume and producing a notification when the absolute amount of data specified here has been sent.

Cancels a request for the amount of data transferred on the entire connection, issued by DataTransferredRequest() .

Cancels a request for the amount of data transferred on a specified subconnection, issued by DataTransferredRequest() .

Gets the amount of data that has been transferred by the entire connection.

since v7.0s

Gets the amount of data that has been transferred by the specified subconnection.

Enumerates the number of currently active interfaces.

Asks the server to gather information on the currently active subconnections.

Since SymbianOS v9.5

Reads current CommDb settings for the active connection.

Gets information about one of the currently active connections.

Note that the actual connection information is gathered on a call to EnumerateConnections() and GetConnectionInfo() is simply used to return the information to the client. Therefore, if the state of the connections change after the EnumerateConnections() call, then the information returned by GetConnectionInfo() may be out of date.

Since SymbianOS v9.5

Reads current CommDb settings for the active connection.

Since SymbianOS v9.5

Reads current CommDb settings for the active connection.

Since SymbianOS v9.5

Reads current CommDb settings for the active connection.

Since SymbianOS v9.5

Reads current CommDb settings for the active connection.

Gets an option.

Gets information about one of the currently active subconnections.

This function is used when a valid TSubConnectionUniqueId has been discovered using the alternative form of GetSubConnectionInfo() , and the client wishes to update its TSubConnectionInfo-derived structure with the latest subconnection information.

Gets information about one of the currently active subconnections.

This function is intended for the initial enumeration of connections, when no TSubConnectionUniqueIds are available, so the client must iterate through the list of subconnections.

Get information on the connection in an asynchronous manner

Get information on the connection in an asynchronous manner

Checks whether the connection is active or inactive.

Notes whether any data is passed for aSecs after the time of call before responding. If data is passed the connection is considered active; otherwise it is considered inactive.

Checks whether the subconnection is active or has changed state (active/inactive)

Obtains information about the last Progress() call which failed with an error.

Gets the unique name of an RConnection .

Used to create an RConnection which is a clone of an existing RConnection (possibly in a different process).

Opens a new RConnection instance.

Opens a new RConnection instance cloned from an existing RConnection instance.

Obtains the current progress information for the connection.

Obtains the current progress information on a specified subconnection.

Requests asynchronous progress notification for the connection.

Requests asynchronous progress notification for a subconnection.

NOTE: This function is not supported and will correctly return KErrNotSupported.

Checks that the Session Handle passed is the same as that of this RConnection .

Use to verify the RConnection argument passed to the RSocket and RHostResolver Open(..., RConnection & aConnection) methods.

Requests service change notification from the agent. This call completes if the underlying service changes (i.e. ISP, GPRS APN or LAN Service). Important: It Panics if used BEFORE "RConnecion::Open(...)" being called.

Sets an option.

Speculative method - Not yet supported Do not call this function, it has ony been introduced for symmetry with RConnection::GetParameters and will be completed at a later date.

Start a connection asynchonously using the default connection preferences.

The request completes once the connection is fully up or an error has occurred. Successful completion will be accompanied by a KConnectionUp progress.

If an RConnection has been stopped or has gone down, any subsequent start will act in the same way as a start with a new RConnection . i.e. The preferences from previous starts will not be used.

Start a connection asynchonously using the connection preferences specified.

The connection preferences can be of type TConnSnapPref , TCommDbConnPref, TCommDbMultiConnPref or TConnPrefList . See the definitions of these classes to see their usage.

The request completes once the connection is fully up or an error has occurred. Successful completion will be accompanied by a KConnectionUp progress.

If an RConnection has been stopped or has gone down, any subsequent start will act in the same way as a start with a new RConnection . i.e. The preferences from previous starts will not be used.

Start a connection synchonously using the default connection preferences.

The request completes once the connection is fully up or an error has occurred. Successful completion will be accompanied by a KConnectionUp progress.

If an RConnection has been stopped or has gone down, any subsequent start will act in the same way as a start with a new RConnection . i.e. The preferences from previous starts will not be used.

Start a connection synchonously using the connection preferences specified.

The connection preferences can be of type TConnSnapPref , TCommDbConnPref, TCommDbMultiConnPref or TConnPrefList . See the definitions of these classes to see their usage.

The request completes once the connection is fully up or an error has occurred. Successful completion will be accompanied by a KConnectionUp progress.

If an RConnection has been stopped or has gone down, any subsequent start will act in the same way as a start with a new RConnection . i.e. The preferences from previous starts will not be used.

Stops the entire connection by disconnecting the underlying network interface immediately, regardless of whether other clients are using it or not.

Applications using the connection will be sent the socket error code KErrCancel. The application generally responds with clean up operations and pop-up boxes alerting the user to the termination of the application.

Stops the entire connection by disconnecting the underlying network interface immediately, regardless of whether other clients are using it or not.

If the argument is EStopNormal this is identical to calling Stop() with no argument. If it is EStopAuthoritative then applications using the connection will be sent the socket error code KErrConnectionTerminated, which generally results in the applications closing quietly (without pop-up boxes).

Stops a subconnection.

Applications will be sent a socket error code to indicate that they must perform clean up operations.

Stop a subconnection on an interface

Subscribe for an incoming session on this connection.

Synchronously wait for an incoming session on this connection.

Identifies the intended use of the connection.

Identifies the type of requirement for stopping the connection.