InternetGetConnectedStateExW 函数 (wininet.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

TBD

[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) 。
 

注意

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

要求

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

另请参阅

建立与 Internet 的拨号连接

WinINet 函数