通过

InternetCheckConnectionA 函数 （wininet.h）

  • 项目

[InternetCheckConnection 可用于“要求”部分中指定的操作系统。 在后续版本中可能会更改或不可用。 请改用 NetworkInformation.GetInternetConnectionProfile 或 NLM 接口。 ]

允许应用程序检查是否可以建立与 Internet 的连接。

语法

BOOL InternetCheckConnectionA(
  [in] LPCSTR lpszUrl,
  [in] DWORD  dwFlags,
  [in] DWORD  dwReserved
);

参数

[in] lpszUrl

指向 null终止字符串的指针，该字符串指定要用于检查连接的 URL。 此值可以 NULL。

[in] dwFlags

选项。 FLAG_ICC_FORCE_CONNECTION是当前唯一可用的标志。 如果设置了此标志，它将强制建立连接。 按以下顺序尝试套接字连接：

  • 如果 lpszUrl 为非NULL，则会从中提取主机值，用于 ping 该特定主机。
  • 如果 lpszUrlNULL，并且最近的服务器的内部服务器数据库中有一个条目，则会从该条目中提取主机值，用于 ping 该服务器。

[in] dwReserved

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

返回值

如果连接成功或 FALSE，则返回 TRUE。 使用 GetLastError 检索错误代码。 如果无法建立连接或套接字数据库无条件脱机，则 ERROR_NOT_CONNECTED getLastError 返回ERROR_NOT_CONNECTED。

言论

已弃用 InternetCheckConnection。 InternetCheckConnection 在使用 Web 代理服务器访问 Internet 的环境中不起作用。 根据环境，请改用 NetworkInformation.GetInternetConnectionProfile 或 NLM 接口 检查 Internet 访问。

注意 WinINet 不支持服务器实现。 此外，不应从服务使用它。 对于服务器实现或服务，请使用 Microsoft Windows HTTP 服务（WinHTTP）。
 

注意

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

要求

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

另请参阅

启用 Internet 功能

WinINet 函数