通过

RasEnumDevicesA 函数 （ras.h）

  • 项目

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

语法

DWORD RasEnumDevicesA(
  [in]      LPRASDEVINFOA unnamedParam1,
  [in, out] LPDWORD       unnamedParam2,
  [out]     LPDWORD       unnamedParam3
);

参数

[in] unnamedParam1

指向接收 RASDEVINFO 结构的缓冲区的指针，每个支持 RAS 的设备都有一个。 在调用函数之前，请将缓冲区中第一个 RASDEVINFO 结构的 dwSize 成员设置为 sizeof（RASDEVINFO） 以标识结构的版本。

[in, out] unnamedParam2

指向一个变量的指针，该变量包含 lpRasDevInfo 缓冲区的大小（以字节为单位）。

输出时，该函数将此变量设置为枚举设备所需的字节数。

注释  

若要确定所需的缓冲区大小，请调用 RasEnumDevices，并将 lpRasDevInfo 设置为 NULL。 l 指向的变量应设置为零。 该函数将返回 l 中所需的缓冲区大小，并返回 ERROR_BUFFER_TOO_SMALL的错误代码。

 

[out] unnamedParam3

指向接收写入 lpRasDevInfo 缓冲区的 RASDEVINFO 结构的变量的指针。

返回值

如果函数成功，则返回值 ERROR_SUCCESS。

如果函数失败，则返回值是以下错误代码之一或来自 路由和远程访问错误代码 或 Winerror.h 的值。

价值 意义
ERROR_BUFFER_TOO_SMALL
 lpRasDevInfo 缓冲区不够大。 l 参数小于 lpRasDevInfo 参数中应设置的 dwSize 成员。 该函数返回 l指向的变量中所需的缓冲区大小。
ERROR_NOT_ENOUGH_MEMORY
 指示内存不足。 lpRasDevInfo 参数为非NULL，l 参数为非NULL，内部内存分配失败。 这可能是由于内存不足的情况造成的。
ERROR_INVALID_PARAMETER
 指示参数值无效。 l 参数 NULL，或者 lpcDevices 参数 NULL。
ERROR_INVALID_USER_BUFFER
 lpRasDevInfo 指定的地址或缓冲区无效。 dwSizelpRasDevInfo 参数的成员不等于 sizeof（RASDEVINFO）。

言论

以下示例代码枚举当前计算机上的设备。 该代码最初使用 NULL的 lpRasDevInfo 参数调用 RasEnumDevices，以获取应传入的缓冲区的大小。 该代码还将第一个 RASDEVINFO 结构的 dwSize 成员设置为 sizeof（RASDEVINFO）以指定结构的版本。

#include <windows.h>
#include <stdio.h>
#include "ras.h"
#include "raserror.h"
#pragma comment(lib, "rasapi32.lib")

DWORD __cdecl wmain(){

    DWORD dwCb = 0;
    DWORD dwRet = ERROR_SUCCESS;
    DWORD dwDevices = 0;
    LPRASDEVINFO lpRasDevInfo = NULL;
    
    // Call RasEnumDevices with lpRasDevInfo = NULL. dwCb is returned with the required buffer size and 
    // a return code of ERROR_BUFFER_TOO_SMALL
    dwRet = RasEnumDevices(lpRasDevInfo, &dwCb, &dwDevices);

    if (dwRet == ERROR_BUFFER_TOO_SMALL){
        // Allocate the memory needed for the array of RAS structure(s).
        lpRasDevInfo = (LPRASDEVINFO) HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, dwCb);
        if (lpRasDevInfo == NULL){
            wprintf(L"HeapAlloc failed!\n");
            return 0;
        }
        // The first RASDEVINFO structure in the array must contain the structure size
        lpRasDevInfo[0].dwSize = sizeof(RASDEVINFO);
        
        // Call RasEnumDevices to enumerate RAS devices
        dwRet = RasEnumDevices(lpRasDevInfo, &dwCb, &dwDevices);

        // If successful, print the names of the RAS devices
        if (ERROR_SUCCESS == dwRet){
            wprintf(L"The following RAS devices were found:\n");
            for (DWORD i = 0; i < dwDevices; i++){
                         wprintf(L"%s\n", lpRasDevInfo[i].szDeviceName);
                  }
        }
        //Deallocate memory for the connection buffer
        HeapFree(GetProcessHeap(), 0, lpRasDevInfo);
        lpRasDevInfo = NULL;
        return 0;
    }

    // There was either a problem with RAS or there are no RAS devices to enumerate    
    if(dwDevices >= 1){
        wprintf(L"The operation failed to acquire the buffer size.\n");
    }else{
        wprintf(L"There were no RAS devices found.\n");
    }

    return 0;
}

注意

ras.h 标头将 RasEnumDevices 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 ras.h
库 Rasapi32.lib
DLL Rasapi32.dll

另请参阅

RASDEVINFO

远程访问服务（RAS）概述

远程访问服务函数