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)