通过

RasGetAutodialParamA 函数 （ras.h）

  • 项目

RasGetAutodialParam 函数检索 AutoDial 参数的值。

语法

DWORD RasGetAutodialParamA(
  [in]      DWORD   unnamedParam1,
  [out]     LPVOID  unnamedParam2,
  [in, out] LPDWORD unnamedParam3
);

参数

[in] unnamedParam1

指定要检索的 AutoDial 参数。 此参数可以是下列值之一。

价值 意义
RASADP_DisableConnectionQuery
 lpvValue 参数返回 DWORD 值。 如果此值为零（默认值），则自动显示一个对话框，用于在创建连接之前查询用户。 如果此值为 1，并且 AutoDial 数据库具有要拨号的电话簿条目，则 AutoDial 将创建连接而不显示对话框。
RASADP_LoginSessionDisable
 lpvValue 参数返回 DWORD 值。 如果此值为 1，系统将禁用当前登录会话的所有自动连接。 如果此值为零（默认值），则启用自动连接。 当新用户登录到工作站时，自动文件系统服务会将此值更改为零。
RASADP_SavedAddressesLimit
 lpvValue 参数返回一个 DWORD 值，该值指示自动序列化存储在注册表中的最大地址数。 AutoDial 首先存储用于创建自动连接地址;然后，它会存储创建 RAS 连接后学习的地址。 使用 RasSetAutodialAddress 函数编写的地址始终保存，并且不包括在计算限制中。 默认值为 100。
RASADP_FailedConnectionTimeout
 lpvValue 参数返回指示超时值的 DWORD 值（以秒为单位）。 当自动连接尝试失败时，AutoDial 系统服务将禁用后续尝试在超时期间访问同一地址。 这样可以防止应用程序为同一逻辑请求显示多个连接对话框。 默认值为 5。
RASADP_ConnectionQueryTimeout
 lpvValue 参数指向指示超时值的 DWORD 值（以秒为单位）。 在尝试自动连接之前，系统将显示一个对话框，要求用户确认系统应拨号。 该对话框具有倒计时计时器，当用户不执行任何操作时，将终止具有“不拨号”选择的对话。 lpvValue 指向的 DWORD 值指定此倒计时计时器的初始时间。

[out] unnamedParam2

指向接收指定参数值的缓冲区的指针。

[in, out] unnamedParam3

指向 DWORD 值的指针。

在输入时，将此值设置为指示 lpvValue 缓冲区的大小（以字节为单位）。

在输出中，此值指示写入缓冲区的值的实际大小。

返回值

如果函数成功，则返回值 ERROR_SUCCESS。

如果函数失败，则返回值是以下错误代码之一或来自 路由和远程访问错误代码 或 Winerror.h 的值。

价值 意义
ERROR_INVALID_PARAMETER
 dwKey 或 lpvValue 参数无效。
ERROR_INVALID_SIZE
 lpdwcbValue 指定的大小太小。

言论

注意

ras.h 标头将 RasGetAutodialParam 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 ras.h
库 Rasapi32.lib
DLL Rasapi32.dll

另请参阅

RasSetAutodialAddress

RasSetAutodialParam

远程访问服务（RAS）概述

远程访问服务函数