功能

语法

参数

返回值

备注(注意)

要求

功能

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

语法

BOOL InternetGetConnectedState(

__out LPDWORD lpdwFlags,

__in DWORD dwReserved

);

参数

lpdwFlags[out]

指向一个变量，该变量接收连接描述内容。该参数在函数返回FLASE时仍可以返回一个有效的标记。该参数可以为下列值的一个或多个。

值　含义

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。

返回值

当存在一个modem或一个LAN连接时，返回TRUE，当不存在internet连接或所有的连接当前未被激活时，返回false。

当该函数返回false时，程序可以调用GetLastError来接收错误代码。

备注

该函数如果返回TRUE，表明至少有一个连接是有效的。它并不能保证这个有效的连接是连向一个指定的主机。程序应该经常检查利用API连接到服务器的返回错误代码，用以判断连接状态。使用InternetCheckConnection函数可以判断一个连接到指定主机的连接是否建立。

返回值为TRUE也表明一个modem连接处于激活状态或一个LAN连接处于激活状态。而FALSE代表modem和LAN均不处于连接状态。如果返回FALSE，INTERNET_CONNECTION_CONFIGURED 标识将被设置，以表明自动拨号被设置为“总是拨号”，但当前不处于激活状态。如果自动拨号未被设置，函数返回FALSE。

正像WinINet API的其他其它函数，此函数不能从DLLMain或者全局构造函数、析构函数安全调用。

注意

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

要求

最低客户机需求　Windows 2000 Professional

最低服务器需求　Windows 2000 Server

头文件　Wininet.h

库　Wininet.lib

动态链接库　Wininet.dll