RasGetConnectStatus

DWORD RasGetConnectStatus(
  _In_    HRASCONN        hrasconn,
  _Inout_ LPRASCONNSTATUS lprasconnstatus
);

说明

该函数用于获取指定远程访问连接的当前状态。应用程序可以使用此函数来检测一个异步的RasDial调用是否完成。

参数

hrasconn [in]

指定要获取状态的连接句柄。

lprasconnstatus [in, out]

指向用于接收连接状态信息的RASCONNSTATUS结构。调用前将结构成员dwSize设置为sizeof(RASCONNSTATUS)。

返回值

成功时返回ERROR_SUCCESS。
失败时返回以下列表中的值之一或来自Routing and Remote Access Error Codes或Winerror.h中定义的错误码。

值	含义
ERROR_NOT_ENOUGH_MEMORY	无法分配足够的内存来完成操作。

注意事项

该函数的返回值不一定与RASCONNSTATUS结构中的dwError相同。函数返回值指示在调用该函数期间是否有错误发生。而dwError指示阻碍连接建立的错误。

系统支持

客户端最小支持	Windows 2000专业版
服务端最小支持	Windows 2000 Server
Header	Ras.h
Library	Rasapi32.lib
DLL	Rasapi32.dll
Unicode和ANSI名称	RasGetConnectStatusW(Unicode)和RasGetConnectStatusA(ANSI)