RasSetAutodialAddressA 函数（ras.h）

项目
11/20/2024

RasSetAutodialAddress 函数可以将地址添加到自动映射数据库。或者，该函数可以删除或修改与数据库中现有地址关联的数据。

语法

DWORD RasSetAutodialAddressA(
  [in] LPCSTR              unnamedParam1,
  [in] DWORD               unnamedParam2,
  [in] LPRASAUTODIALENTRYA unnamedParam3,
  [in] DWORD               unnamedParam4,
  [in] DWORD               unnamedParam5
);

参数

[in] unnamedParam1

指向 null-terminated 字符串的指针，该字符串指定要添加、删除或修改的地址。此地址可以是 IP 地址、Internet 主机名（“www.microsoft.com”），或 NetBIOS 名称（“products1”）。

如果此参数 NULL，则该函数将设置默认 Internet 连接（请参阅“备注” ）。如果此参数指向零长度字符串，该函数将删除默认 Internet 连接。

[in] unnamedParam2

保留;必须为零。

[in] unnamedParam3

指向要与 lpszAddress 地址关联的一个或多个 RASAUTODIALENTRY 结构的数组的指针。如果 lpAutoDialEntriesNULL，dwcbAutoDialEntries 为零，RasSetAutodialAddress 会从映射数据库中删除与 lpszAddress 关联的所有结构。

[in] unnamedParam4

指定 lpAutoDialEntries 缓冲区的大小（以字节为单位）。

[in] unnamedParam5

指定 lpAutoDialEntries 缓冲区中的 RASAUTODIALENTRY 结构的数目。

返回值

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

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

价值	意义
ERROR_INVALID_SIZE	RASAUTODIALENTRY 结构的 dwSize 成员是无效值。
ERROR_INVALID_PARAMETER	lpszAddress 参数 NULL。
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	lpAutoDialEntries 中指定的连接名称不存在。

言论

自动映射数据库中的地址可以具有任意数量的关联 RASAUTODIALENTRY 条目。每个条目指定特定 TAPI 拨号位置的自动拨号信息。

如果 lpszAddress 参数指定的地址是数据库中的现有地址，并且 lpAutoDialEntries 参数不 NULL，则 RasSetAutodialAddress 函数将修改与地址关联的 AutoDial 条目集。如果 lpAutoDialEntries 中的条目 数组指定地址已有条目的拨号位置，该函数会将现有条目替换为新条目。否则，该函数只需将 lpAutoDialEntries 条目添加到地址的条目集。

如果数据库中存在 lpszAddress 地址，lpAutoDialEntries为 NULL，lpAutoDialEntries 为零，RasSetAutodialAddress 从数据库中删除该地址。

如果数据库中不存在 lpszAddress 地址，RasSetAutodialAddress 将地址添加到数据库。 lpAutoDialEntries 参数指定要与新地址关联的自动序列化条目。

RAS 支持全局到本地计算机的默认 Internet 连接，并支持每个用户的默认 Internet 连接。

当 lpszAddress 参数 NULL时，lpAutoDialEntries 参数指定具有一个条目的连接名称，RasSetAutodialAddress 将连接设置为默认 Internet 连接。 lpAutoDialEntries 中指定的连接名称应已存在。否则，将返回 ERROR_CANNOT_FIND_PHONEBOOK_ENTRY。

如果 lpszAddress 参数为零长度的字符串，并且 lpAutoDialEntries 参数指定一个空连接名称（一个条目）时，RasSetAutodialAddress 删除默认 Internet 连接。

在非域客户端计算机上，如果用户想要将连接设置为默认 Internet 连接，并在 szEntry RASAUTODIALENTRY 结构的成员中指定“for-all-users”连接，则会在本地计算机上全局设置默认 Internet 连接。在所有其他情况下，将单独为计算机的每个用户设置默认 Internet 连接。

如果将一个连接配置为“所有用户”连接，另一个连接配置为“仅限我”连接，则有可能有两个连接具有相同名称。如果 lpAutoDialEntries 参数指定与全局连接和每用户连接对应的连接名称，则会设置每用户连接。

注意

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

要求

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