RasEnumConnections
计算机系统
返回一个RASCONN结构数组的缓存的长指针,对于每一个RAS连接。在调用本函数之前,必须设置缓存中RASCONN结构的第一个成员dwSize的值,即RASCONN的大小,为了在不同系统版本中通过,请用sizeof(RASCONN)取得大小
RasEnumConnections (电话簿相关操作,结尾附赠使用例子)
本函数列出所有活动RAS连接,返回每一个连接句柄和电话簿入口名
函数原型:
DWORD RasEnumConnections(
LPRASCONN lprasconn,
LPDWORD lpcb,
LPDWORD lpcConnections
);
参数信息:
lprasconn
lpcb
一个长指针,指向的变量是lprasconn指向的缓存中存储的字节个数,返回时,本函数将已经被列举的所有RAS连接需要的字节个数赋值到lpcb中
lpcConnections
长指针,本函数设置会回写这个参数,设置有多少个 RASCONN结构被写入到 lprasconn指向的缓存中
返回值:
返回0则成功
返回非0值则错误,返回值的宏定义在 Raserror头文件中,例如ERROR_BUFFER_TOO_SMALL (缓存太小) ERROR_NOT_ENOUGH_MEMORY (内存不足)
必要条件:
操作系统:Windows CE
版本:大于等于1.0
定义位置:Ras.h, Afdfunc.h
包含头文件:Ras.h, Afdfunc.h
预编译lib文件:Ppp.lib
相关参考:
RasEnumEntries, RasGetConnectStatus, RASCONN
使用范例:
//下面建立了10个RAS连接
RASCONN rasCon[10];
rasCon[0].dwSize=sizeof(RASCONN);
DWORD dwSize;
dwSize=sizeof(RASCONN)*10;
DWORD dwConNum=0;
RasEnumConnections(rasCon,&dwSize,&dwConNum);
后卫大师编辑版:19:03 2009-9-2
参考资料
最新修订时间:2024-03-28 14:48
目录
概述
参考资料