[New - Windows NT]
RasGetAutodialParam函数检索AutoDial参数的值。
DWORD RasGetAutodialParam
DWORD 【dwKey】, | //表示要检索的参数 |
LPVOID 【lpvValue】, | //指向接收该值的缓冲区的指针 |
LPDWORD 【lpdwcbValue】 | //缓冲区的大小(以字节为单位) |
); |
参数
【dwKey】
表示要检索的AutoDial参数。此参数可以是以下值之一。
值 | 含义 |
RASADP_DisableConnectionQuery | 【lpvValue】参数返回一个DWORD值。如果此值为零(默认值),AutoDial会在创建连接之前显示一个对话框来查询用户。如果此值为1,并且自动拨号数据库具有要拨打的电话簿条目,则自动拨号将创建连接,而不显示对话框。 |
RASADP_LoginSessionDisable | 【lpvValue】参数返回一个DWORD值。如果此值为1,系统将禁用当前登录会话的所有自动拨号连接。如果此值为零(默认值),则启用自动拨号连接。当新用户登录到工作站时,AutoDial系统服务将此值更改为零。 |
RASADP_SavedAddressesLimit | 【lpvValue】参数返回一个DWORD值,表示AutoDial在注册表中存储的最大地址数。自动拨号首先存储用于创建自动拨号连接的地址;那么它存储在创建RAS连接之后学到的地址。使用RasSetAutodialAddress函数编写的地址始终保存,不包括在计算限制中。默认值为100。 |
RASADP_FailedConnectionTimeout | 【lpvValue】参数返回一个DWORD值,表示超时值(以秒为单位)。当自动拨号连接尝试失败时,自动拨号系统服务将禁用在超时时间段内到达相同地址的后续尝试。这样可以防止自动拨号显示应用程序对同一逻辑请求的多个连接对话框。默认值为5。 |
【lpvValue】
指向接收指定参数值的缓冲区。
【lpdwcbValue】
指向DWORD值。在输入时,设置此值以指示【lpvValue】缓冲区的大小(以字节为单位)。在输出时,该值表示写入缓冲区的值的实际大小。
返回值
如果函数成功,返回值为零。
如果函数失败,则返回值可以是以下错误代码之一。
值 | 含义 |
ERROR_INVALID_PARAMETER | 【dwKey】或【lpvValue】参数无效。 |
ERROR_INVALID_SIZE | 【lpdwcbValue】指定的大小太小。 |
也可以看看