RasGetConnectStatusA 函数（ras.h）

项目
11/20/2024

RasGetConnectStatus 函数检索有关指定远程访问连接的当前状态的信息。应用程序可以使用此调用来确定异步 RasDial 调用何时完成。

语法

DWORD RasGetConnectStatusA(
  [in]      HRASCONN         unnamedParam1,
  [in, out] LPRASCONNSTATUSA unnamedParam2
);

参数

[in] unnamedParam1

指定要检索其状态的远程访问连接。必须从 RasDial 或 RasEnumConnections获取此句柄。

[in, out] unnamedParam2

指向 RASCONNSTATUS 结构的指针，该结构在输出中接收状态信息。

在输入时，将结构的 dwSize 成员设置为 sizeof（RASCONNSTATUS），以便标识要传递的结构的版本。

返回值

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

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

价值	意义
ERROR_NOT_ENOUGH_MEMORY	该函数无法分配足够的内存来完成操作。

言论

RasGetConnectStatus 的返回值不一定等于 RasGetConnectStatus返回的 RASCONNSTATUS 结构的 dwError 成员的值。 RasGetConnectStatus 的返回值 指示在 RasGetConnectStatus 函数调用期间发生的错误，而 dwError 成员表示阻止建立连接的错误。

注意

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

要求

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