rasGetConnectStatusA 函数 (ras.h)
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 中的值。
| 值 | 含义 |
|---|---|
|
函数无法分配足够的内存来完成操作。 |
注解
RasGetConnectStatus 的返回值不一定等于 RasGetConnectStatus 返回的 RASCONNSTATUS 结构的 dwError 成员的值。 RasGetConnectStatus 的返回值指示在 RasGetConnectStatus 函数调用期间发生的错误，而 dwError 成员指示阻止建立连接的错误。
注意
ras.h 标头将 RasGetConnectStatus 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | ras.h |
| Library | Rasapi32.lib |
| DLL | Rasapi32.dll |