RasGetAutodialAddress

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)