DWORD RasGetAutodialAddress(
_In_ LPCTSTR lpszAddress,
_In_ LPDWORD lpdwReserved,
_Inout_ LPRASAUTODIALENTRY lpAutoDialEntries,
_Inout_ LPDWORD lpdwcbAutoDialEntries,
_Out_ LPDWORD lpdwcAutoDialEntries
);
说明
该函数从AutoDial对照表中提取出所有与指定网络地址关联的条目。
参数
lpszAddress [in]
指定网络地址。可以IP地址、域名或NetBIOS名称。
该参数为NULL时,返回每个用户的默认网络连接条目。如果未配置,则返回全局默认网络连接条目。如果仍未配置,则lpdwcbAutoDialEntries和lpdwcAutoDialEntries指向的变量被设置为0返回。
lpdwReserved [in]
保留未用,必须为NULL。
lpAutoDialEntries [in, out]
指向RASAUTODIALENTRY结构的数组指针,用于接收条目,每个结构一个条目。调用前将第一个结构的dwSize设置为sizeof(RASAUTODIALENTRY)。
该参数为NULL时,函数设置lpdwcbAutoDialEntries指向的变量为实际需要的缓冲字节数、lpdwcAutoDialEntries指向的变量为条目数量。
lpdwcbAutoDialEntries [in, out]
指定lpAutoDialEntries指向的缓冲长度,或者接收实际需要的缓冲字节数。
lpdwcAutoDialEntries [out]
接收条目数量。
返回值
成功时返回ERROR_SUCCESS。
失败时返回下列表格中的错误码之一或是来自Routing and Remote Access Error Codes或Winerror.h中定义的错误码。
值 | 含义 |
---|
ERROR_INVALID_SIZE | RASAUTODIALENTRY结构的dwSize值无法识别。 |
ERROR_INVALID_PARAMETER | 参数lpszAddress、lpdwcbAutoDialEntries、lpdwcAutoDialEntries为NULL。 |
注意事项
RAS支持全局默认连接,同时也支持每个用户的默认连接。
全局默认连接的名称存储在以下注册表项中:
HKEY_LOCAL_MACHINE\Software\Microsoft\Ras AutoDial\Default。存储名称的键名为DefaultInternet,类型是REG_SZ。
全局默认连接必须配置为所有用户可用。
每个用户的默认连接名称存储在以下注册表项中: HKEY_CURRENT_USER\Software\Microsoft\Ras Autodial\Default。存储名称的键名为DefaultInternet,类型是REG_SZ。
系统支持
客户端最小支持 | Windows 2000专业版 |
---|
服务端最小支持 | Windows 2000 Server |
Header | Ras.h |
Library | Rasapi32.lib |
DLL | Rasapi32.dll |
Unicode和ANSI名称 | RasGetAutodialAddressW(Unicode)和RasGetAutodialAddressA(ANSI) |