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