通过

InternetGetConnectedStateExW 函数 （winineti.h）

  • 项目
请注意，不建议使用此 API，请改用 INetworkListManager：：GetConnectivity 方法。
 
检索指定 Internet 连接的连接状态。

语法

BOOL InternetGetConnectedStateExW(
  [out] LPDWORD lpdwFlags,
  [out] LPWSTR  lpszConnectionName,
        DWORD   cchNameLen,
  [in]  DWORD   dwReserved
);

参数

[out] lpdwFlags

指向接收连接说明的变量的指针。 即使函数返回 FALSE，此参数也可能返回有效的标志。 此参数可以是以下值的组合。

价值 意义
INTERNET_CONNECTION_CONFIGURED
0x40
 本地系统具有与 Internet 的有效连接，但它可能或当前未连接。
INTERNET_CONNECTION_LAN
0x02
 本地系统使用局域网连接到 Internet。
INTERNET_CONNECTION_MODEM
0x01
 本地系统使用调制解调器连接到 Internet。
INTERNET_CONNECTION_MODEM_BUSY
0x08
 不再使用。
INTERNET_CONNECTION_OFFLINE
0x20
 本地系统处于脱机模式。
INTERNET_CONNECTION_PROXY
0x04
 本地系统使用代理服务器连接到 Internet。

[out] lpszConnectionName

指向接收连接名称的字符串值的指针。

cchNameLen

待定

[in] dwReserved

此参数是保留的，必须 NULL。

返回值

如果存在 Internet 连接，则返回 TRUE;如果没有 Internet 连接，或者所有可能的 Internet 连接当前都未处于活动状态，则返回 FALSE。 有关详细信息，请参阅“备注”部分。

InternetGetConnectedState 返回 FALSE时，应用程序可以调用 GetLastError 来检索错误代码。

言论

从 InternetGetConnectedState 返回值为 TRUE 表示至少有一个连接到 Internet 的连接可用。 它不保证可以建立与特定主机的连接。 应用程序应始终检查从连接到服务器的 API 调用返回的错误。 可以调用 InternetCheckConnection 以确定是否可以建立与特定目标的连接。

返回值为 TRUE 表示调制解调器连接处于活动状态，或者 LAN 连接处于活动状态，并且为 LAN 正确配置了代理。 FALSE 的返回值指示调制解调器和 LAN 均未连接。 如果返回 FALSE，则 INTERNET_CONNECTION_CONFIGURED 标志可以设置为指示自动拨号配置为“始终拨号”，但当前未处于活动状态。 如果未配置自动序列化，函数将返回 FALSE。

与 WinINet API 的其他所有方面一样，不能从 DllMain 或全局对象的构造函数和析构函数中安全地调用此函数。

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

注意

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

要求

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

另请参阅

建立与 Internet 的拨号连接

WinINet 函数