共用方式為

InternetGetConnectedState 函式 (wininet.h)

  • 發行項
注意 不建議使用此 API，請改用 INetworkListManager：：GetConnectivity 方法。
 
擷取本機系統的連線狀態。

語法

BOOL InternetGetConnectedState(
  [out] LPDWORD lpdwFlags,
  [in]  DWORD   dwReserved
);

參數

[out] lpdwFlags

接收連接描述之變數的指標。 即使函式傳回 FALSE，此參數仍可能會傳回有效的旗標。 此參數可以是下列一或多個值。

值 意義
INTERNET_CONNECTION_CONFIGURED
0x40
 本機系統具有與因特網的有效連線，但可能或可能目前未連線。
INTERNET_CONNECTION_LAN
0x02
 本機系統會使用局域網路連線到因特網。
INTERNET_CONNECTION_MODEM
0x01
 本機系統會使用數據機來連線到因特網。
INTERNET_CONNECTION_MODEM_BUSY
0x08
 不再使用。
INTERNET_CONNECTION_OFFLINE
0x20
 本機系統處於離線模式。
INTERNET_CONNECTION_PROXY
0x04
 本機系統會使用 Proxy 伺服器連線到因特網。
INTERNET_RAS_INSTALLED
0x10
 本機系統已安裝 RAS。

[in] dwReserved

此參數是保留的，而且必須是 0。

傳回值

如果有作用中的數據機或 LAN 因特網連線，則傳回 TRUE ;如果沒有因特網連線，則傳回 FALSE;如果所有可能的因特網連線目前都未使用中，則傳回 FALSE 。 如需詳細資訊，請參閱＜備註＞一節。

當 InternetGetConnectedState 傳回 FALSE 時，應用程式可以呼叫 GetLastError 來擷取錯誤碼。

備註

來自 InternetGetConnectedState 的傳回值表示至少有一個因特網連線可供使用。 它不保證可以建立與特定主機的連線。 應用程式應該一律檢查從連線到伺服器的 API 呼叫傳回的錯誤。 您可以呼叫 InternetCheckConnection 來判斷是否可以建立特定目的地的連線。

TRUE 的傳回值表示數據機聯機為使用中，或 LAN 連線為使用中，且 Proxy 已針對 LAN 正確設定。 FALSE 的傳回值表示數據機和 LAN 都未連線。 如果傳回 FALSE ， 則INTERNET_CONNECTION_CONFIGURED 旗標可能會設定為表示自動串行設定為「永遠撥號」，但目前未使用中。 如果未設定自動串行化，函式會傳回 FALSE。

就像 WinINet API 的其他所有層面一樣，無法在 DllMain 或全域物件的建構函式和解構函式內安全地呼叫此函式。

注意 WinINet 不支援伺服器實作。 此外，它不應該從服務使用。 對於伺服器實作或服務，請使用 Microsoft Windows HTTP 服務 (WinHTTP) 。
 

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 wininet.h (包括 Wininet.h)
程式庫 Wininet.lib
Dll Wininet.dll

另請參閱

建立因特網的撥號連線

WinINet 函式