RasGetAutodialAddress

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

[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