InternetGetConnectedStateEx 函数 (winineti.h)

注意 不建议使用此 API,请改用 INetworkListManager::GetConnectivity 方法。
 
检索指定 Internet 连接的连接状态。

语法

BOOL InternetGetConnectedStateEx(
  [out] LPDWORD lpdwFlags,
  [out] LPSTR   lpszConnectionName,
  [in]  DWORD   dwNameLen,
  [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

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

[in] dwNameLen

lpszConnectionName 字符串的大小(以 TCHAR 为单位)。

[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 标志设置为指示自动拨号配置为“始终拨号”,但当前不处于活动状态。 如果未配置自动ial,则函数返回 FALSE

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

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

要求

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

另请参阅

建立与 Internet 的拨号连接

WinINet 函数