Progress information for connections

Support is provided for indicating to an application the progress of a dial-up connection.

This is useful because the process of dialling an ISP, logging in and starting network protocols can be quite lengthy, taking up to a minute in some cases.

An application can find the current stage of the dial-up connection, using RNif prior to v7.0S and RConnection in v7.0S onwards. In addition, the application can get the last error which occurred in setting up the connection.

Prior to v7.0S, the dial-up networking system uses the RGenericAgent API as an agent of the Network Interface Manager and keeps track of its progress in establishing a connection and any errors which have occurred.

In general, progress information is not restricted to dial-up connections, but is also available for direct connections, callback connections and dial-in connections.