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

[in] dwReserved

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

返回值

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

注解

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

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

注意

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

要求

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

另请参阅

启用 Internet 功能

WinINet 函数