RasEnumConnections功能列出所有活动的RAS连接。它返回每个连接的句柄和电话簿条目名称。
DWORD RasEnumConnections(
LPRASCONN 【// buffer to receive connections data】, | //缓冲区来接收连接数据 |
LPDWORD 【LPCB】, | //以字节为单位的缓冲区大小 |
LPDWORD 【// number of connections written to buffer】 | //写入缓冲区的连接数 |
); |
参数
【// buffer to receive connections data】
指向接收RASCONN结构数组的缓冲区,每个RAS连接一个。在调用该函数之前,应用程序必须将缓冲区中的第一个RASCONN结构的的dwSize成员设置为sizeof(RASCONN),以便标识正在传递的结构的版本。
【LPCB】
指向包含【// buffer to receive connections data】指定的缓冲区大小(以字节为单位)的变量。返回时,函数将此变量设置为枚举RAS连接所需的字节数。
【// number of connections written to buffer】
指向一个变量,该函数设置为由【// buffer to receive connections data】指定的写入缓冲区的RASCONN结构数。
返回值
如果函数成功,返回值为零。
如果函数失败,则返回值是RAS头文件中列出的非零错误值,或ERROR_BUFFER_TOO_SMALL或ERROR_NOT_ENOUGH_MEMORY中的一个。
备注
如果没有指定电话簿条目名称进行连接,则为该连接返回的信息将给出连接电话号码前面的“。”。
也可以看看