[New - Windows NT]
RasSetAutodialAddress功能可以向AutoDial映射数据库添加一个地址。或者,该函数可以删除或修改与数据库中现有地址相关联的数据。
DWORD RasSetAutodialAddress(af
LPTSTR 【lpszAddresshu】, | //指向网络地址字符串的指针 |
DWORD 【//保留,必须设置为零】, | //保留;必须为零 |
LPRASAUTODIALENTRY 【lpAutoDialEntries】, | //指向包含自动拨号条目数据的缓冲区的指针 |
DWORD 【dwcbAutoDialEntries】, | //缓冲区的大小(以字节为单位) |
DWORD 【dwcAutoDialEntries】 | //缓冲区中的条目数 |
); |
参数
【lpszAddresshu】
指向指定要添加,删除或修改的地址的以空值终止的字符串。这可以是IP地址(“127.95.1.4”),Internet主机名(“www.microsoft.com”)或NetBIOS名称(“products1”)。
【//保留,必须设置为零】
Reserved; must be zero.
【lpAutoDialEntries】
指向要与【lpszAddresshu】地址相关联的一个或多个RASAUTODIALENTRY结构的数组的指针。如果【lpAutoDialEntries】为NULL且【dwcbAutodialEntries】为零,RasSetAutodialAddress将从映射数据库中删除与【lpszAddresshu】关联的所有结构。
【dwcbAutoDialEntries】
指定【lpAutodialEntries】缓冲区的大小(以字节为单位)。
【dwcAutoDialEntries】
指定【lpAutoDialEntries】缓冲区中RASAUTODIALENTRY个结构的数量。
返回值
如果函数成功,返回值为零。
如果函数失败,则返回值是以下错误代码之一。
值 | 含义 |
ERROR_INVALID_SIZE | 的dwSize RASAUTODIALENTRY结构的成员是无效值。 |
ERROR_INVALID_PARAMETER | 【lpszAddresshu】参数为NULL。 |
备注
AutoDial映射数据库中的一个地址可以有任意数量的关联的RASAUTODIALENTRY条目。每个条目指定特定TAPI拨号位置的自动拨号信息。
如果【lpszAddresshu】参数指定的地址是数据库中的现有地址,并且【lpAutoDialEntries】参数不为NULL,则RasSetAutodialAddress功能将修改与该地址相关联的一组自动拨号条目。如果【lpAutoDialEntries】数组中的条目指定了该地址已经有一个条目的拨号位置,该函数将使用新条目替换现有条目。否则,该函数只需将【lpAutoDialEntries】条目添加到该地址的一组条目中即可。
如果数据库中存在【lpszAddresshu】地址,并且【lpAutoDialEntries】为NULL且【dwcbAutodialEntries】为零,RasSetAutodialAddress将从数据库中删除该地址。
如果数据库中不存在【lpszAddresshu】地址,RasSetAutodialAddress将地址添加到数据库。【lpAutoDialEntries】参数指定要与新地址关联的自动拨号条目。
也可以看看
RASAUTODIALENTRY, RasEnumAutodialAddresses, RasGetAutodialAddress