共用方式為

InternetGetConnectedStateExW 函式 （winineti.h）

  • 發行項
不建議使用此 API，請改用 INetworkListManager：：GetConnectivity 方法。
 
擷取指定之因特網連線的連線狀態。

語法

BOOL InternetGetConnectedStateExW(
  [out] LPDWORD lpdwFlags,
  [out] LPWSTR  lpszConnectionName,
        DWORD   cchNameLen,
  [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 伺服器來連線到因特網。

[out] lpszConnectionName

接收連接名稱之字串值的指標。

cchNameLen

待定

[in] dwReserved

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

傳回值

如果有因特網連線，或 FALSE 沒有因特網連線，或如果所有可能的因特網連線目前未使用中，則傳 回 true。 如需詳細資訊，請參閱一節。

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

言論

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

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

如同 WinINet API 的其他所有層面，無法從 DllMain 或全域物件的建構函式和解構函式安全地呼叫此函式。

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

注意

winineti.h 標頭會根據 UNICODE 預處理器常數的定義，將 InternetGetConnectedStateEx 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 winineti.h （包括 Wininet.h、Winineti.h、Wininet.h、Winineti.h）
連結庫 Wininet.lib
DLL Wininet.dll

另請參閱

建立因特網的撥號連線

WinINet 函式