InternetGetConnectedStateExA 函式 (winineti.h)
語法
BOOL InternetGetConnectedStateExA(
[out] LPDWORD lpdwFlags,
[out] LPSTR lpszConnectionName,
DWORD cchNameLen,
[in] DWORD dwReserved
);
參數
[out] lpdwFlags
接收連接描述之變數的指標。 即使函式傳回 FALSE，此參數仍可能會傳回有效的旗標。 此參數可以是下列值的組合。
[out] lpszConnectionName
接收連接名稱的字串值指標。
cchNameLen
TBD
[in] dwReserved
此參數是保留的，而且必須是 NULL。
傳回值
如果有因特網連線，則傳回 TRUE ;如果沒有因特網連線，則傳回 FALSE;如果所有可能的因特網連線目前都未使用中，則傳回 TRUE 。 如需詳細資訊，請參閱＜備註＞一節。
當 InternetGetConnectedState 傳回 FALSE 時，應用程式可以呼叫 GetLastError 來擷取錯誤碼。
備註
來自 InternetGetConnectedState 的傳回值表示至少有一個因特網連線可供使用。 它不保證可以建立與特定主機的連線。 應用程式應該一律檢查從連線到伺服器的 API 呼叫傳回的錯誤。 您可以呼叫 InternetCheckConnection 來判斷是否可以建立特定目的地的連線。
TRUE 的傳回值表示數據機聯機為使用中，或 LAN 連線為使用中，且 Proxy 已針對 LAN 正確設定。 FALSE 的傳回值表示數據機和 LAN 都未連線。 如果傳回 FALSE ， 則INTERNET_CONNECTION_CONFIGURED 旗標可能會設定為表示自動串行設定為「永遠撥號」，但目前未使用中。 如果未設定自動串行化，函式會傳回 FALSE。
就像 WinINet API 的其他所有層面一樣，無法在 DllMain 或全域物件的建構函式和解構函式內安全地呼叫此函式。
注意
winineti.h 標頭會根據 UNICODE 預處理器常數的定義，將 InternetGetConnectedStateEx 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | winineti.h (包括 Wininet.h、Winineti.h、Wininet.h、Winineti.h) |
| 程式庫 | Wininet.lib |
| Dll | Wininet.dll |