InternetCheckConnectionW 函数 (wininet.h)
[InternetCheckConnection 可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 请改用 NetworkInformation.GetInternetConnectionProfile 或 NLM 接口。 ]
如果可以建立与 Internet 的连接，则允许应用程序检查。
语法
BOOL InternetCheckConnectionW(
[in] LPCWSTR 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.h 标头将 InternetCheckConnection 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | wininet.h |
| Library | Wininet.lib |
| DLL | Wininet.dll |