RasEnumDevices

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

[New - Windows NT]

RasEnumDevices函数返回所有可用RAS设备的名称和类型。

DWORD RasEnumDevices(

LPRASDEVINFO【lpRasDevInfo】,//缓冲区以接收关于RAS设备的信息
LPDWORD 【LPCB】,//缓冲区的大小(以字节为单位)
LPDWORD 【lpcDevices】//接收写入缓冲区的条目数
); 

参数

【lpRasDevInfo】

指向接收RASDEVINFO结构数组的缓冲区的指针,每个支持RAS的设备一个。在调用该函数之前,将缓冲区中第一个RASDEVINFO结构的的dwSize成员设置为sizeof(RASDEVINFO)以标识结构的版本。

【LPCB】

指向包含【lpRasDevInfo】缓冲区大小(以字节为单位)的变量。返回时,函数将此变量设置为枚举设备所需的字节数。

要确定所需的缓冲区大小,请调用RasEnumDevices 【lpRasDevInfo】参数设置为NULL,并将由【LPCB】指向的变量设置为零。该函数返回由【LPCB】指向的变量中所需的缓冲区大小。

【lpcDevices】

指向变量的指针,该变量的函数设置为写入【lpRasDevInfo】缓冲区的RASDEVINFO结构的数量。

返回值

如果函数成功,返回值为零。

如果函数失败,则返回值为非零RAS错误值或以下错误代码之一。

含义
ERROR_BUFFER_TOO_SMALL【lpRasDevInfo】缓冲区不够大。该函数返回由【LPCB】指向的变量中所需的缓冲区大小。
ERROR_NOT_ENOUGH_MEMORY表示内存不足
ERROR_INVALID_PARAMETER表示无效的参数值。
ERROR_INVALID_USER_BUFFER【lpRasDevInfo】指定的地址或缓冲区无效。

也可以看看

RASDEVINFO