[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】指定的地址或缓冲区无效。 |
也可以看看