RasSetAutodialParam

DWORD RasSetAutodialParam(
  _In_  DWORD  dwKey,
  _Out_ LPVOID lpvValue,
  _In_  DWORD  dwcbValue
);

说明

该函数用于设置自动拨号参数。

参数

dwKey [in]

指定自动拨号参数。可以是下列表格列出的值之一。

值	含义
RASADP_DisableConnectionQuery	lpvValue参数指向一个DWORD变量。若设置为0（默认值），拨号时会显示一个窗口向用户询问拨号条目。若设置为1，并且自动拨号数据库设置了拨号条目，则拨号时自动使用该条目进行连接。
RASADP_LoginSessionDisable	lpvValue参数指向一个DWORD变量。若设置为1，系统禁止当前登录会话进行自动拨号。若设置为0（默认值），则允许自动拨号。当有新用户登录时自动拨号服务自动将此值设置为0。
RASADP_SavedAddressesLimit	lpvValue参数指向一个DWORD变量。该值指示可存储在注册表中的最大拨号地址数量。自动拨号服务首先会将用于自动拨号连接的地址存储，然后当有RAS连接创建时也会将地址存储。使用RasSetAutodialAddress函数写入地址时不受此值限制，并且不会被计算到存储上限值中。默认上限是100。
RASADP_FailedConnectionTimeout	lpvValue参数指向一个DWORD变量。该值指示一个以秒为单位的超时时间。当自动拨号连接失败时，在超时时间内不会再拨同一个地址。该设置可确保应用程序不会同时显示多个拨号连接对话框。默认值是5秒。
RASADP_ConnectionQueryTimeout	lpvValue参数指向一个DWORD变量。该值指示一个以秒为单位的拨号超时时间。尝试拨号时，系统会显示一个询问用户是否立即拨号的倒计时窗口。当超时后用户没有确认时，将自动选择不拨号。该值即倒计时时间。

lpvValue [out]

指向需要设置新值的缓冲。

dwcbValue [in]

指定lpvValue缓冲字节数。

返回值

成功时返回ERROR_SUCCESS。
失败时返回来自Routing and Remote Access Error Codes或Winerror.h中定义的错误码。

值	含义
ERROR_INVALID_PARAMETER	dwKey或lpvValue参数不合法。
ERROR_INVALID_SIZE	dwcbValue指定的缓冲长度不正确。

系统支持

客户端最小支持	Windows 2000专业版
服务端最小支持	Windows 2000 Server
Header	Ras.h
Library	Rasapi32.lib
DLL	Rasapi32.dll
Unicode和ANSI名称	RasSetAutodialParamW(Unicode)和RasSetAutodialParamA(ANSI)