|
Paused States
During a connection operation, there can be times when the remote server
cannot proceed without additional information from the local user. Beginning with
Microsoft® Windows NT® version 3.5, the RasDial function supports paused states. A paused state allows the Remote Access
Connection Manager to suspend a connection operation so the RAS client application
can collect information from the user.
Paused states are useful in the following situations:
- When the user needs to provide a callback number.
- When the user authentication fails, the user can type in a different user name
and password.
- When the user's password has expired, the user can provide a new password.
By default, paused state support is disabled. RAS clients that want to support
paused states must set the RDEOPTS_PausedStates flag in the RASDIALEXTENSIONS structure passed as a parameter to RasDial.
When a paused state occurs, the Remote Access Connection Manager invokes the
client's notification handler. If paused state support is disabled, the
notification message indicates an error, and the connection operation fails. If it is
enabled, the Connection Manager pauses the connection operation to wait for the
RAS client's response. The RAS client can resume the connection operation by a
second RasDial call, or terminate it by calling the RasHangUp function.
After getting the user's input, the RAS client restarts the connection
operation by calling RasDial again. This second RasDial call must specify the following information:
- The connection handle that was returned by the original RasDial call.
- The same notification handler as the original RasDial call.
- The user's input in the appropriate members of the RASDIALPARAMS structure. Other members of the RASDIALPARAMS structure should have the same information as specified in the original RasDial call.
The second RasDial call cannot be made from within the notification handler.
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
