|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| No
| Import Library
| rasapi32.lib
| Header File
| ras.h
| Unicode
| WinNT
| Platform Notes
| None
|
|
|
RasHangUp
The RasHangUp function terminates a remote access connection. The connection is specified
with a RAS connection handle. The function releases all RASAPI32.DLL resources
associated with the handle.
DWORD RasHangUp(
HRASCONN hrasconn
| // handle to the RAS connection to hang up
| );
|
|
Parameters
hrasconn
Identifies the remote access connection to terminate. This is a handle
returned from a previous call to RasDial or RasEnumConnections.
Return Values
If the function succeeds, the return value is zero.
If the function fails, the return value is a nonzero error value listed in the
RAS header file, or ERROR_INVALID_HANDLE.
Remarks
The connection is terminated even if the RasDial call has not yet been completed.
After this call, the hrasconn handle can no longer be used.
An application should not call RasHangUp and then immediately exit. The connection state machine needs time to
properly terminate. If the system prematurely terminates the state machine, the state
machine may fail to properly close a port, leaving the port in an inconsistent
state. A simple way to avoid this problem is to call Sleep(3000) after returning from RasHangUp; after that pause, the application can exit. A more responsive way to avoid
the problem is, after returning from RasHangUp, to call RasGetConnectStatus(hrasconn) and Sleep(0) in a loop until RasGetConnectStatus returns ERROR_INVALID_HANDLE.
See Also
RASCONN, RasDial, RasEnumConnections, RasGetConnectStatus, Sleep
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
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
|
