RasHangUpA 函数 (ras.h)
RasHangUp 函数终止远程访问连接。 使用 RAS 连接句柄指定连接。 函数释放与句柄关联的所有 RASAPI32.DLL 资源。
语法
DWORD RasHangUpA(
[in] HRASCONN unnamedParam1
);
参数
[in] unnamedParam1
指定要终止的远程访问连接。 这是从上一次调用 RasDial 或 RasEnumConnections 返回的句柄。
返回值
如果函数成功,则返回值 ERROR_SUCCESS。
如果函数失败,则返回值为以下错误代码之一,或者来自 路由和远程访问错误代码 或 Winerror.h 的值。
值 | 含义 |
---|---|
|
hrasconn 中指定的句柄无效。 |
注解
即使 RasDial 调用尚未完成,连接也会终止。
在此调用之后,不能再使用 hrasconn 句柄。
应用程序不应调用 RasHangUp ,然后立即退出。 连接状态机需要时间才能正确终止。 如果系统过早终止状态机,则状态机可能无法正确关闭端口,使端口处于不一致状态。 此外,立即尝试使用相同的连接可能会失败,使连接不可用。 避免这些问题的一种简单方法是在从 RasHangUp 返回后调用 Sleep (3000) ;暂停后,应用程序可以退出。 在从 RasHangUp 返回后,在循环中调用 RasGetConnectStatus (hrasconn) 和 Sleep (0) ,直到 RasGetConnectStatus 返回 ERROR_INVALID_HANDLE。
可以在 RasGetSubEntryHandle 返回的句柄上调用 RasHangUp,以终止多链接连接中的单个链接。 但是,在这种情况下,不能使用 RasGetConnectStatus 来确定链接是否终止;即使链接成功终止, RasGetConnectStatus 也可能不会返回 ERROR_INVALID_HANDLE 。
注意
ras.h 标头将 RasHangUp 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | ras.h |
Library | Rasapi32.lib |
DLL | Rasapi32.dll |