通过

InternetDial 函数 (winineti.h)

  • 项目

使用调制解调器启动与 Internet 的连接。

语法

DWORD InternetDial(
  [in]  HWND    hwndParent,
  [in]  LPSTR   lpszConnectoid,
  [in]  DWORD   dwFlags,
  [out] LPDWORD lpdwConnection,
  [in]  DWORD   dwReserved
);

参数

[in] hwndParent

父窗口的句柄。

[in] lpszConnectoid

指向 以 null 结尾的字符串的指针，该字符串指定要使用的拨号连接的名称。 如果此参数包含空字符串 (“”) ，则用户选择连接。 如果此参数为 NULL，则该函数将连接到自动ial 连接。

[in] dwFlags

选项。 此参数的取值可为下列值之一：

值 含义
INTERNET_AUTODIAL_FORCE_ONLINE
 强制联机连接。
INTERNET_AUTODIAL_FORCE_UNATTENDED
 强制无人参与的 Internet 拨号。 如果需要用户干预，函数将失败。
INTERNET_DIAL_FORCE_PROMPT
 忽略“自动拨号”设置并强制显示拨号用户界面。
INTERNET_DIAL_UNATTENDED
 通过调制解调器连接到 Internet，而不显示用户界面（如果可能）。 否则，函数将等待用户输入。
INTERNET_DIAL_SHOW_OFFLINE
 在拨号用户界面中显示 “脱机工作 ”按钮，而不是“ 取消 ”按钮。

[out] lpdwConnection

指向指定连接号的变量的指针。 此数字是可在其他函数（如 InternetHangUp）中使用的连接的唯一标识符。

[in] dwReserved

此参数是保留的，必须为 NULL。

返回值

如果成功，则返回ERROR_SUCCESS，否则返回错误值。 错误代码可以是以下值之一。

返回代码 说明
ERROR_INVALID_PARAMETER
 一个或多个参数不正确。
ERROR_NO_CONNECTION
 拨号连接存在问题。
ERROR_USER_DISCONNECTION
 用户单击 Internet 连接对话框中的 “脱机工作 ”或“ 取消 ”按钮。

注解

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

注意 从 Windows Vista 和 Windows Server 2008 开始，WinINet 拨号函数使用 RAS 函数 建立拨号连接。 WinINet 支持 RasDialDlg 函数中记录的功能。
 
与 WinINet API 的所有其他方面一样，无法从 DllMain 或全局对象的构造函数和析构函数中安全地调用此函数。
注意 WinINet 不支持服务器实现。 此外，不应从服务使用它。 对于服务器实现或服务，请使用 Microsoft Windows HTTP Services (WinHTTP) 。
 

要求

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

另请参阅

建立与 Internet 的拨号连接

WinINet 函数