RasGetConnectStatus
RasGetConnectStatus
本函数返回远程存取连接的当前状态。当异步调用RasDial完成时,一个应用程序可以使用本函数来确定状态。
函数原型:
DWORD RasGetConnectStatus(
HRASCONN rasconn,
LPRASCONNSTATUS lprasconnstatus );
参数:
rasconn
用来得到远程存取连接的状态的句柄。本句柄必须从 RasDial 或者 RasEnumConnections 函数得到。
lprasconnstatus
一个RASCONNSTATUS 结构的指针,本函数把状态信息存入该指针。调用函数之前,一个应用程序必须设置RASCONNSTATUS结构对象的dwSize成员取得结构大小,推荐使用sizeof(RASCONNSTATUS)取得大小,防止操作系统版本不同取得大小不同。
返回值
0表示成功。一个在RAS头文件中列出的非零值 或者 ERROR_BUFFER_TOO_SMALL 或者 ERROR_NOT_ENOUGH_MEMORY 表示失败。包含 Raserror.h头文件用来定义RAS的错误码
必要条件
操作系统 Windows CE
版本 大于等于1.0
定义位置:Ras.h, Afdfunc.h
预处理lib文件Ppp.lib
注:
本API是微软公司提供的完整 Windows CE操作系统包的一部分。这个功能取决于原始设备制造商,有些设备可能不支持这个API。
相关参考:
RASCONNSTATUS, RasDial, RasEnumConnections
后卫大师制作版 12:03 2009-9-4