InternetGetConnectedState

编辑:请问网互动百科 时间:2020-05-28 05:16:05
编辑 锁定
本词条缺少名片图,补充相关内容使词条更完整,还能快速升级,赶紧来编辑吧!
InternetGetConnectedState,函数名称,此函数返回本地系统的网络连接状态。
中文名
InternetGetConnectedState
性    质
函数名称
功    能
返回本地系统的网络连接状态
最低客户要求
Windows 2000 Professional

InternetGetConnectedState功能

编辑
此函数返回本地系统的网络连接状态。

InternetGetConnectedState语法

编辑
BOOL InternetGetConnectedState(
__out LPDWORD lpdwFlags,
__in DWORD dwReserved
);

InternetGetConnectedState参数

编辑
lpdwFlags[out]
指向一个变量,该变量接收连接描述内容。该参数在函数返回FALSE时仍可以返回一个有效的标记。该参数可以为下列值的一个或多个。
含义
INTERNET_CONNECTION_CONFIGURED0x40
Local system has a valid connection to the Internet, but it might or might not be currently connected.
INTERNET_CONNECTION_LAN 0x02
Local system uses a local area network to connect to the Internet.
INTERNET_CONNECTION_MODEM0x01
Local system uses a modem to connect to the Internet.
INTERNET_CONNECTION_MODEM_BUSY0x08
No longer used.
INTERNET_CONNECTION_OFFLINE 0x20
Local system is in offline mode.
INTERNET_CONNECTION_PROXY0x04
Local system uses a proxy server to connect to the Internet.
INTERNET_RAS_INSTALLED0x10
Local system has RAS installed.
dwReserved[in]
保留值。必须为0。

InternetGetConnectedState返回值

编辑
当存在一个modem或一个LAN连接时,返回TRUE,当不存在internet连接或所有的连接当前未被激活时,返回false。
当该函数返回false时,程序可以调用GetLastError来接收错误代码

InternetGetConnectedState备注

编辑
该函数如果返回TRUE,表明至少有一个连接是有效的。它并不能保证这个有效的连接是连向一个指定的主机。程序应该经常检查利用API连接到服务器的返回错误代码,用以判断连接状态。使用InternetCheckConnection函数可以判断一个连接到指定主机的连接是否建立。
返回值为TRUE也表明一个modem连接处于激活状态或一个LAN连接处于激活状态。而FALSE代表modem和LAN均不处于连接状态。如果返回FALSE,INTERNET_CONNECTION_CONFIGURED 标识将被设置,以表明自动拨号被设置为“总是拨号”,但当前不处于激活状态。如果自动拨号未被设置,函数返回FALSE。
正像WinINet API的其他其它函数,此函数不能从DLLMain或者全局构造函数析构函数安全调用。

InternetGetConnectedState注意

编辑
WinINet不支持实现服务器。另外,它也不应该用来作为服务。实现服务器或者服务可用Microsoft Windows HTTP Services (WinHTTP)

InternetGetConnectedState要求

编辑
最低客户机需求
Windows 2000 Professional
最低服务器需求
Windows 2000 Server
头文件
Wininet.h
Wininet.lib
动态链接库
Wininet.dll
词条标签:
计算机学