RasHangUp

DWORD RasHangUp(
  _In_ HRASCONN hrasconn
);

说明

该函数用于关闭一个远程访问连接。由RAS连接句柄代表一个连接。该函数将释放所有与该句柄相关的RASAPI32.DLL资源。

参数

hrasconn [in]

连接句柄。

返回值

成功时返回ERROR_SUCCESS。
失败时返回以下列表中的值之一或来自Routing and Remote Access Error Codes或Winerror.h中定义的错误码。

值	含义
ERROR_INVALID_HANDLE	连接句柄无效。

注意事项

若RasDial函数拨号尚未完成，调用该函数后会立即终止拨号操作。

调用函数后hRasConn句柄不能再被使用。

调用该函数后不应立即退出程序，连接状态机需要一些时间后才能完全终止。如果系统过早的关闭了状态机，状态机将无法正常关闭一个端口，会导致该端口状态混乱。同时，立即尝试使用相同的连接会导致该连接无法使用。应在调用RasHangUp函数后暂停3秒钟再退出程序。一个比较机灵的方法是在RasHangUp返回后调用RasGetConnectStatus(hrasconn)函数，并且调用Sleep(0)后循环，直到函数返回 ERROR_INVALID_HANDLE错误。

可以针对RasGetSubEntryHandle返回的子连接句柄调用RasHangUp来终止一个子连接，但是无法通过RasGetConnectStatus函数来判断子连接是否终止。即便已完全终止，RasGetConnectStatus函数也不一定会返回ERROR_INVALID_HANDLE错误。

系统支持

客户端最小支持	Windows 2000 专业版
服务端最小支持	Windows 2000 Server
Header	Ras.h
Library	Rasapi32.lib
DLL	Rasapi32.dll
Unicode和ANSI名称	RasHangUpW(Unicode)和RasHangUpA(ANSI)