InternetAutodial 函数 (winineti.h)

  • 项目

使调制解调器自动拨号默认 Internet 连接。

语法

BOOL InternetAutodial(
  [in] DWORD dwFlags,
  [in] HWND  hwndParent
);

参数

[in] dwFlags

控制此操作。 此参数的取值可为下列值之一：

值 含义
INTERNET_AUTODIAL_FAILIFSECURITYCHECK
0x04
 如果 Windows 95 或更高版本禁用了文件和打印机共享，则会导致 InternetAutodial 失败。

Windows Server 2008 和 Windows Vista： 此标志已过时。
INTERNET_AUTODIAL_FORCE_ONLINE
0x01
 强制建立联机 Internet 连接。
INTERNET_AUTODIAL_FORCE_UNATTENDED
0x02
 强制无人参与的 Internet 拨号。
INTERNET_AUTODIAL_OVERRIDE_NET_PRESENT
0x08
 即使存在与 Internet 的网络连接，也会使 InternetAutodial 拨号调制解调器连接。

[in] hwndParent

父窗口的句柄。

返回值

如果函数成功，则返回 TRUE。

如果函数失败，则返回 FALSE。 应用程序可以调用 GetLastError 来检索错误代码。

注解

InternetAutodial 不支持双拨号连接、智能卡身份验证或需要基于注册表的认证的连接。

注意 从 Windows Vista 和 Windows Server 2008 开始，WinINet 拨号函数使用 RAS 函数 建立拨号连接。 WinINet 支持 RasDialDlg 函数中记录的功能。
 
如果系统上存在现有的拨号连接，InternetAutodial 不会尝试拨号。 此外，如果存在现有的 LAN 连接，并且 InternetAutodial 未配置为强制拨号 (设置 dwFlags 参数) 中的INTERNET_AUTODIAL_FORCE_ONLINE，则 InternetAutodial 不会尝试拨号连接并返回 TRUE。

与 WinINet API 的所有其他方面一样，无法从 DllMain 或全局对象的构造函数和析构函数中安全地调用此函数。

注意 WinINet 不支持服务器实现。 此外，不应从服务使用它。 对于服务器实现或服务，请使用 Microsoft Windows HTTP Services (WinHTTP) 。
 

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winineti.h (包括 Wininet.h)
Library Wininet.lib
DLL Wininet.dll

另请参阅

建立与 Internet 的拨号连接

WinINet 函数