RasGetAutodialAddressA 函数（ras.h）

项目
11/20/2024

RasGetAutodialAddress 函数检索与自动映射数据库中网络地址关联的所有自动序列化条目的相关信息。

语法

DWORD RasGetAutodialAddressA(
  [in]      LPCSTR              unnamedParam1,
  [in]      LPDWORD             unnamedParam2,
  [in, out] LPRASAUTODIALENTRYA unnamedParam3,
  [in, out] LPDWORD             unnamedParam4,
  [out]     LPDWORD             unnamedParam5
);

参数

[in] unnamedParam1

指向 null-terminated 字符串的指针，该字符串指定请求信息的地址。这可以是 IP 地址、Internet 主机名（“www.microsoft.com”），或 NetBIOS 名称（“products1”）。

如果此参数 NULL，则该函数将检索默认 Internet 连接。如果配置了 Internet 连接，该函数将返回每个用户的默认 Internet 连接。否则，该函数将返回全局默认 Internet 连接。如果未配置默认 Internet 连接，则函数将返回 lpdwcbAutoDialEntries，lpdwcAutoDialEntries 参数。

[in] unnamedParam2

保留;必须为 NULL。

[in, out] unnamedParam3

指向缓冲区的指针，该缓冲区在输出中接收 RASAUTODIALENTRY 结构的数组，每个自动处理项对应于与 lpszAddress 参数指定的地址关联的每个 AutoDial 条目。

在输入时，将缓冲区中第一个 RASAUTODIALENTRY 结构中的 dwSize 成员设置为 sizeof（RASAUTODIALENTRY），以标识结构的版本。

如果 lpAutoDialEntriesNULL，RasGetAutodialAddress 设置 lpdwcbAutoDialEntries 和 lpdwcAutoDialEntries 参数，以指示所需的缓冲区大小、字节数和自动输入项数。

[in, out] unnamedParam4

指向在输入上指定 lpAutoDialEntries 缓冲区的大小（以字节为单位）的变量的指针。

在输出中，此变量接收返回的字节数，或者缓冲区太小时所需的字节数。

[out] unnamedParam5

指向接收 lpAutoDialEntries 缓冲区中返回的结构元素数的变量的指针。

返回值

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

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

价值	意义
ERROR_INVALID_SIZE	RASAUTODIALENTRY 结构的 dwSize 成员是无效值。
ERROR_INVALID_PARAMETER	lpszAddress、lpdwcbAutoDialEntries或 lpdwcAutoDialEntries 参数 NULL。

言论

远程访问服务（RAS）支持默认 Internet 连接。 RAS 支持全局到本地计算机的默认 Internet 连接，此外，还支持每个用户的默认 Internet 连接。

全局默认 Internet 连接的名称存储在以下注册表项下面的注册表中：

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Ras Autodial
            Default

存储连接名称的值为：

DefaultInternet

此值的类型为 REG_SZ。

全局默认 Internet 连接必须配置为 “连接文件夹” 用户界面中的所有用户 连接。

每用户默认 Internet 连接的名称存储在以下注册表项下面的注册表中：

HKEY_CURRENT_USER\软件\Microsoft\Ras 自动\默认

存储连接名称的值为：

DefaultInternet

此值的类型为 REG_SZ。

注意

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

要求

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