RasSetAutodialAddress

【勇芳软件工作室】汉化HomePreviousNext

[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