通过

InternetDialA 函数 （wininet.h）

  • 项目

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

语法

DWORD InternetDialA(
  [in]  HWND      hwndParent,
  [in]  LPSTR     lpszConnectoid,
  [in]  DWORD     dwFlags,
  [out] DWORD_PTR *lpdwConnection,
  [in]  DWORD     dwReserved
);

参数

[in] hwndParent

父窗口的句柄。

[in] lpszConnectoid

指向 null终止字符串的指针，该字符串指定要使用的拨号连接的名称。 如果此参数包含空字符串（“），则用户选择连接。 如果此参数 NULL，则该函数将连接到自动连接。

[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 不支持双拨号连接、智能卡身份验证或需要基于注册表的认证的连接。

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

注意

wininet.h 标头将 InternetDial 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 wininet.h （包括 Wininet.h、Winineti.h、Wininet.h、Winineti.h）
库 Wininet.lib
DLL Wininet.dll

另请参阅

建立与 Internet 的拨号连接

WinINet 函数