|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| No
| Import Library
| -
| Header File
| ras.h
| Unicode
| No
| Platform Notes
| None
|
|
|
RASCONNSTATE
The RASCONNSTATE enumeration type contains values that specify the states that may occur
during a RAS connection operation. If you use the RasDial function to establish a RAS connection, you can specify a window, or a RasDialFunc, RasDialFunc1, or RasDialFunc2 callback function to receive notification messages that report the current
connection state. You can also use the RasGetConnectStatus function to get the connection state for a specified connection.
typedef enum _RASCONNSTATE {
RASCS_OpenPort = 0,
RASCS_PortOpened,
RASCS_ConnectDevice,
RASCS_DeviceConnected,
RASCS_AllDevicesConnected,
RASCS_Authenticate,
RASCS_AuthNotify,
RASCS_AuthRetry,
RASCS_AuthCallback,
RASCS_AuthChangePassword,
RASCS_AuthProject,
RASCS_AuthLinkSpeed,
RASCS_AuthAck,
RASCS_ReAuthenticate,
RASCS_Authenticated,
RASCS_PrepareForCallback,
RASCS_WaitForModemReset,
RASCS_WaitForCallback,
RASCS_Projected,
#if (WINVER >= 0x400)
RASCS_StartAuthentication, // Windows 95 only
RASCS_CallbackComplete, // Windows 95 only
RASCS_LogonNetwork, // Windows 95 only
#endif
RASCS_SubEntryConnected,
RASCS_SubEntryDisconnected,
RASCS_Interactive = RASCS_PAUSED,
RASCS_RetryAuthentication,
RASCS_CallbackSetByCaller,
RASCS_PasswordExpired,
RASCS_Connected = RASCS_DONE,
RASCS_Disconnected
} RASCONNSTATE ;
The enumerator values are listed here in the general order in which the
connection states occur. However, you should not write code that depends on the order
or occurrence of particular RASCONNSTATE connection states, because this may vary between platforms.
Enumerator
| Meaning
| RASCS_OpenPort
| The communication port is about to be opened.
| RASCS_PortOpened
| The communication port has been opened successfully.
| RASCS_ConnectDevice
| A device is about to be connected. RasGetConnectStatus can be called to determine the name and type of the device being connected.
| RASCS_DeviceConnected
| A device has connected successfully. RasGetConnectStatus can be called to determine the name and type of the device being connected.
|
| For a simple modem connection, RASCS_ConnectDevice and RASCS_DeviceConnected will be called only once. For a dial-up X.25 PAD connection, the pair will be
called first for the modem, then for the PAD. If a preconnect switch is
configured, the pair will be called for the switch before any other devices connect.
Likewise, the pair will be called for a postconnect switch after any other
devices connect.
Windows 95: Note that Windows 95 does not currently support multistage connections such
as the X.25 PAD connection described earlier.
| RASCS_AllDevicesConnected
| All devices in the device chain have successfully connected. At this point,
the physical link is established.
| RASCS_Authenticate
| The authentication process is starting. Remote access does not allow the
remote client to generate any traffic on the LAN until authentication has been
successfully completed.
Remote access authentication on a Windows NT or Windows 95 server consists of:
- Validating the user name/ password on the specified domain.
- Projecting the client onto the LAN. This means that the remote access server
does what is necessary to send and receive data on the LAN on behalf of the
client. For example, the remote access server might need to add a NetBIOS name that
corresponds to the client's computer name.
- Call-back processing in which the client hangs up and the server calls back.
(The user needs special permissions on the remote access server for this.)
- Calculating the link speed. This is necessary to correctly set transport
time-outs to match the relatively slow speed of the remote link.
| RASCS_AuthNotify
| An authentication event has occurred. If dwError is zero, this event will be immediately followed by one of the more specific
authentication states following. If dwError is nonzero, authentication has failed, and the error value indicates why.
| RASCS_AuthRetry
| The client has requested another validation attempt with a new user
name/password/domain. This state does not occur in Windows NT version 3.1.
| RASCS_AuthCallback
| The remote access server has requested a callback number. This occurs only if
the user has "Set By Caller" callback privilege on the server.
| RASCS_AuthChangePassword
| The client has requested to change the password on the account. This state
does not occur in Windows NT version 3.1.
| RASCS_AuthProject
| The projection phase is starting.
| RASCS_AuthLinkSpeed
| The link-speed calculation phase is starting.
| RASCS_AuthAck
| An authentication request is being acknowledged.
| RASCS_ReAuthenticate
| Reauthentication (after callback) is starting.
| RASCS_Authenticated
| The client has successfully completed authentication.
| RASCS_PrepareForCallback
| The line is about to disconnect in preparation for callback.
| RASCS_WaitForModemReset
| The client is delaying in order to give the modem time to reset itself in
preparation for callback.
| RASCS_WaitForCallback
| The client is waiting for an incoming call from the remote access server.
| RASCS_Projected
| This state occurs after the RASCS_AuthProject state. It indicates that
projection result information is available. You can access the projection result
information by calling RasGetProjectionInfo.
| RASCS_StartAuthentication
| Windows 95 only: Indicates that user authentication is being initiated or retried.
| RASCS_CallbackComplete
| Windows 95 only: Indicates that the client has been called back and is about to resume
authentication.
| RASCS_LogonNetwork
| Windows 95 only: Indicates that the client is logging on to the network.
| RASCS_SubEntryConnected
| When dialing a multilink phone-book entry, this state indicates that a
subentry has been connected during the dialing process. The dwSubEntry parameter of a RasDialFunc2 callback function indicates the index of the subentry. When the final state
of all subentries in the phone-book entry has been determined, the connection
state is RASCS_Connected if one or more subentries have been connected successfully.
| RASCS_SubEntryDisconnected
| When dialing a multilink phone-book entry, this state indicates that a
subentry has been disconnected during the dialing process. The dwSubEntry parameter of a RasDialFunc2 callback function indicates the index of the subentry.
| RASCS_Interactive
| This state corresponds to the terminal state supported by RASPHONE.EXE. This
state does not occur in Windows NT version 3.1.
| RASCS_RetryAuthentication
| This state corresponds to the retry authentication state supported by
RASPHONE.EXE. This state does not occur in Windows NT version 3.1.
| RASCS_CallbackSetByCaller
| This state corresponds to the callback state supported by RASPHONE.EXE. This
state does not occur in Windows NT version 3.1.
| RASCS_PasswordExpired
| This state corresponds to the change password state supported by RASPHONE.EXE.
This state does not occur in Windows NT version 3.1.
| RASCS_Connected
| Successful connection.
| RASCS_Disconnected
| Disconnection or failed connection.
|
Remarks
The connection process states are divided into three classes: running states,
paused states, and terminal states.
An application can easily determine the class of a specific state by
performing Boolean bit operations with the RASCS_PAUSED and RASCS_DONE bitmasks. Here
are some examples:
fDoneState = (state & RASCS_DONE);
fPausedState = (state & RASCS_PAUSED);
fRunState = !(fDoneState || fPausedState);
See Also
RasDial, RasGetConnectStatus, RasGetProjectionInfo, RASCONNSTATUS
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
