RasHangUp功能终止远程访问连接。连接由RAS连接句柄指定。该函数释放与句柄相关联的所有RASAPI32.DLL资源。
Dvord Rshangup(hi-Latn
HRASCONN 【hrasconn】 | // RAS连接的句柄挂断 |
); |
参数
【hrasconn】
标识要终止的远程访问连接。这是从以前调用RasDial或RasEnumConnections返回的句柄。
返回值
如果函数成功,返回值为零。
如果函数失败,则返回值是RAS头文件中列出的非零错误值,或ERROR_INVALID_HANDLE。
备注
即使RasDial呼叫尚未完成,连接也将终止。
此呼叫后,【hrasconn】句柄不能再被使用。
应用程序不应调用RasHangUp然后立即退出。连接状态机需要时间才能正常终止。如果系统提前终止状态机,状态机可能无法正确关闭端口,使端口处于不一致的状态。避免这个问题的一个简单方法是从RasHangUp返回后调用睡觉(3000);暂停后,应用程序可以退出。在RasHangUp从RasGetConnectStatus返回RasGetConnectStatus(【hrasconn】)和睡觉(0)之后,一个更有反应的方式可以避免这个问题,直到RasGetConnectStatus返回ERROR_INVALID_HANDLE为止。
也可以看看
RASCONN, RasDial, RasEnumConnections, RasGetConnectStatus, 睡觉