Share via

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

注意

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

規格需求

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

另請參閱

啟用網際網路功能

WinINet 函式