RasEnumConnections

【勇芳软件工作室】汉化HomePreviousNext

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中的一个。

备注

如果没有指定电话簿条目名称进行连接,则为该连接返回的信息将给出连接电话号码前面的“。”。

也可以看看

RASCONN, RasEnumEntries, RasGetConnectStatus