InternetGetConnectedStateExA 函数 (wininet.h)
语法
BOOL InternetGetConnectedStateExA(
[out] LPDWORD lpdwFlags,
[out] LPSTR lpszConnectionName,
DWORD cchNameLen,
[in] DWORD dwReserved
);
参数
[out] lpdwFlags
指向接收连接说明的变量的指针。 即使函数返回 FALSE,此参数也可能返回有效标志。 此参数可以是以下值的组合。
[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.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 |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈