InternetGetConnectedState，函式名稱，此函式返回本地系統的網路連線狀態。
基本介紹
- 中文名：InternetGetConnectedState
- 性質：函式名稱
- 功能：返回本地系統的網路連線狀態
- 最低客戶要求：Windows 2000 Professional
功能,語法,參數,返回值,備註,注意,要求,
功能
此函式返回本地系統的網路連線狀態。
語法
BOOL InternetGetConnectedState(
__out LPDWORD lpdwFlags,
__in DWORD dwReserved
);
參數
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。
返回值
當存在一個modem或一個LAN連線時，返回TRUE，當不存在internet連線或所有的連線當前未被激活時，返回false。
當該函式返回false時，程式可以調用GetLastError來接收錯誤代碼。
備註
該函式如果返回TRUE，表明至少有一個連線是有效的。它並不能保證這個有效的連線是連向一個指定的主機。程式應該經常檢查利用API連線到伺服器的返回錯誤代碼，用以判斷連線狀態。使用InternetCheckConnection函式可以判斷一個連線到指定主機的連線是否建立。
返回值為TRUE也表明一個modem連線處於激活狀態或一個LAN連線處於激活狀態。而FALSE代表modem和LAN均不處於連線狀態。如果返回FALSE，INTERNET_CONNECTION_CONFIGURED 標識將被設定，以表明自動撥號被設定為“總是撥號”，但當前不處於激活狀態。如果自動撥號未被設定，函式返回FALSE。
注意
WinINet不支持實現伺服器。另外，它也不應該用來作為服務。實現伺服器或者服務可用Microsoft Windows HTTP Services (WinHTTP)。
要求
| 最低客戶機需求 | Windows 2000 Professional |
|---|---|
| 最低伺服器需求 | Windows 2000 Server |
| 頭檔案 | Wininet.h |
| 庫 | Wininet.lib |
| 動態程式庫 | Wininet.dll |
