InternetGetConnectedState

tern tern tern

功能

此函式返回本地系統的網路連線狀態。

語法

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