internetCheckConnectionA 函式 (wininet.h)
[InternetCheckConnection 可用於需求一節中指定的作業系統。 它在後續版本中可能會變更或無法使用。 請改用 NetworkInformation.GetInternetConnectionProfile 或 NLM 介面。 ]
允許應用程式檢查是否可以建立與網際網路的連線。
語法
BOOL InternetCheckConnectionA(
[in] LPCSTR lpszUrl,
[in] DWORD dwFlags,
[in] DWORD dwReserved
);
參數
[in] lpszUrl
Null終止字串的指標,指定要用來檢查連線的 URL。 此值可以是 Null。
[in] dwFlags
選項。 FLAG_ICC_FORCE_CONNECTION是唯一可用的旗標。 如果設定此旗標,則會強制連接。 以下列順序嘗試通訊端連線:
- 如果 lpszUrl 不是Null,則會從中擷取主機值,並用來 Ping 該特定主機。
- 如果 lpszUrl 為 Null ,且最接近伺服器的內部伺服器資料庫中有專案,則會從專案擷取主機值,並用來偵測該伺服器。
[in] dwReserved
此參數是保留的,而且必須是 0。
傳回值
如果成功建立連接,則傳回 TRUE ,否則傳回 FALSE 。 使用 GetLastError 擷取錯誤碼。 如果無法建立連線,或通訊端資料庫無條件離線, GetLastError 會傳回ERROR_NOT_CONNECTED。
備註
InternetCheckConnection 已被取代。 InternetCheckConnection 無法在使用 Web Proxy 伺服器存取網際網路的環境中運作。 視環境而定,請改用 NetworkInformation.GetInternetConnectionProfile 或 NLM 介面 來檢查網際網路存取。
注意
wininet.h 標頭會將 InternetCheckConnection 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼,可能會導致編譯或執行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | wininet.h |
程式庫 | Wininet.lib |
Dll | Wininet.dll |