共用方式為

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，則會從中擷取主機值，並用來偵測該特定主機。
  • 如果 lpszUrlNULL，且最接近伺服器的內部伺服器資料庫中有一個專案，則會從專案擷取主機值，並用來偵測該伺服器。

[in] dwReserved

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

傳回值

如果成功建立連線，或 FALSE，則傳 回 true。 使用 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 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 wininet.h
連結庫 Wininet.lib
DLL Wininet.dll

另請參閱

啟用因特網功能

WinINet 函式