[New - Windows NT]
RasGetAutodialAddress功能检索与自动拨号映射数据库中的网络地址相关联的所有AutoDial条目的信息。
DWORD RasGetAutodialAddress(
LPTSTR 【lpszAddresshu】, | //指向网络地址字符串的指针 |
LPDWORD 【lpdwReserved】, | //保留;必须为NULL |
LPRASAUTODIALENTRY 【lpAutoDialEntries】, | //指向自动拨号数据缓冲区的指针 |
LPDWORD 【lpdwcbAutoDialEntries】, | //指向缓冲区大小(以字节为单位)的指针 |
LPDWORD 【lpdwcAutoDialEntries】 | //指向返回的条目数的指针 |
); |
参数
【lpszAddresshu】
指向指定要求哪个信息的地址的以空值终止的字符串的指针。这可以是IP地址(“127.95.1.4”),Internet主机名(“www.microsoft.com”)或NetBIOS名称(“products1”)。
【lpdwReserved】
Reserved; must be NULL.
【lpAutoDialEntries】
指向接收RASAUTODIALENTRY结构数组的缓冲区的指针,每个自动拨号条目与【lpszAddresshu】参数指定的地址相关联的一个。在调用RasGetAutodialAddress之前,将缓冲区中第一个RASAUTODIALENTRY结构的的dwSize成员设置为sizeof(RASAUTODIALENTRY)以标识结构的版本。
如果【lpAutoDialEntries】为NULL,RasGetAutodialAddress设置【lpdwcbAutoDialEntries】和【lpdwcAutoDialEntries】参数,以指示所需的缓冲区大小(以字节为单位)和自动拨号条目数。
【lpdwcbAutoDialEntries】
指向包含【lpAutoDialEntries】缓冲区大小(以字节为单位)的变量。返回时,函数将此变量设置为返回的字节数,或缓冲区太小时所需的字节数。
【lpdwcAutoDialEntries】
指向接收【lpAutoDialEntries】缓冲区中返回的结构元素数量的变量的指针。
返回值
如果函数成功,返回值为零。
如果函数失败,则返回值是以下错误代码之一。
值 | 含义 |
ERROR_XXX_NOT_FOUND | 在映射数据库中找不到该地址。 |
ERROR_INVALID_SIZE | 的dwSize 的dwSize结构的成员是无效值。 |
ERROR_INVALID_PARAMETER | 【lpszAddresshu】,【lpdwcbAutoDialEntries】或【lpdwcAutoDialEntries】参数为NULL。 |
也可以看看
RASAUTODIALENTRY, RasEnumAutodialAddresses, RasSetAutodialAddress