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.
The Network Interface Manager (NifMan) provides an API through its
RNif
base class through which an application can interrogate it
for the current stage of the dial-up connection. In addition, the application
can get the last error which occurred in setting up the connection.
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.
For more information on the Network Interface Manager, see the Symbian OS Communications Technical Paper.