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 函数