RasHangUpA 函数（ras.h）

项目
11/20/2024

RasHangUp 函数终止远程访问连接。使用 RAS 连接句柄指定连接。该函数释放与句柄关联的所有RASAPI32.DLL资源。

语法

DWORD RasHangUpA(
  [in] HRASCONN unnamedParam1
);

参数

[in] unnamedParam1

指定要终止的远程访问连接。这是从上一次调用 rasDial 或 RasEnumConnections返回的句柄。

返回值

如果函数成功，则返回值 ERROR_SUCCESS。

如果函数失败，则返回值是以下错误代码之一或来自路由和远程访问错误代码或 Winerror.h 的值。

价值	意义
ERROR_INVALID_HANDLE	hrasconn 中指定的句柄无效。

言论

即使尚未完成 RasDial 调用，连接也会终止。

在此调用后，hrasconn 句柄不再使用。

应用程序不应调用 RasHangUp，然后立即退出。连接状态机需要时间才能正确终止。如果系统过早终止状态机，状态机可能无法正确关闭端口，使端口处于不一致状态。此外，立即尝试使用相同的连接可能会失败，使连接不可用。避免这些问题的一种简单方法是从 RasHangUp返回后调用睡眠（3000） ;暂停后，应用程序可以退出。避免这些问题的更响应方式是，从 RasHangUp返回后，调用 RasGetConnectStatus（hrasconn），并在循环中睡眠（0），直到 RasGetConnectStatus 返回 ERROR_INVALID_HANDLE。

可以在 RasGetSubEntryHandle 返回的句柄上调用 RasHangUp，以终止多链接连接中的单个链接。但是，在这种情况下，不能使用 RasGetConnectStatus 来确定链接是否终止;即使链接已成功终止，RasGetConnectStatus 也可能不会返回 ERROR_INVALID_HANDLE。

注意

ras.h 标头将 RasHangUp 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。

要求

要求	价值
最低支持的客户端	Windows 2000 Professional [仅限桌面应用]
支持的最低服务器	Windows 2000 Server [仅限桌面应用]
目标平台	窗户
标头	ras.h
库	Rasapi32.lib
DLL	Rasapi32.dll