共用方式為

InternetCheckConnectionW 函式 (wininet.h)

  • 發行項

[InternetCheckConnection 可用於需求一節中指定的操作系統。 它在後續版本中可能會變更或無法使用。 請改用 NetworkInformation.GetInternetConnectionProfile 或 NLM 介面。 ]

允許應用程式檢查是否可以建立因特網的連線。

語法

BOOL InternetCheckConnectionW(
  [in] LPCWSTR 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 不支援伺服器實作。 此外，它不應該從服務使用。 對於伺服器實作或服務，請使用 Microsoft Windows HTTP 服務 (WinHTTP) 。
 

注意

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

規格需求

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

另請參閱

啟用因特網功能

WinINet 函式