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，则该函数将连接到自动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) 。
 

注意

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

要求

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

另请参阅

建立与 Internet 的拨号连接

WinINet 函数