共用方式為

IsDestinationReachableA 函式 (sensapi.h)

  • 發行項

IsDestinationReachable 函式會判斷是否可以連線到指定的目的地，並提供目的地的連線品質 (QOC) 資訊。

Windows Vista 和更新版本、Windows Server 2008 和更新版本： 不支援此函式，且一律會 傳回ERROR_CALL_NOT_IMPLEMENTED。

語法

BOOL IsDestinationReachableA(
  [in]      LPCSTR    lpszDestination,
  [in, out] LPQOCINFO lpQOCInfo
);

參數

[in] lpszDestination

指定目的地之 Null 終止字串的指標。 目的地可以是IP位址、UNC名稱或URL。

[in, out] lpQOCInfo

QOCINFO 結構的指標，可接收連線品質 (QOC) 資訊。 如果您不想收到 QOC 資訊，您可以提供 NULL 指標。

傳回值

傳回碼 Description
TRUE
 可以觸達目的地。
FALSE
 無法連線到目的地。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
ERROR_CALL_NOT_IMPLEMENTED
 Windows Vista 不提供此函式。

備註

用戶端應用程式會使用此函式來判斷 QOC 資訊，再繼續進行網路作業。 對於透過網路卡或遠端訪問伺服器直接連線到網路的獨立計算機， (RAS) ，此函式會產生最少的網路流量，而 RPC 呼叫最接近的路由器。 對於使用 RAS 或網路閘道可觸達目的地之網路的電腦，此函式會 Ping 目的地以產生精確的 QOC 資訊。

此函式僅適用於 TCP/IP 連線。 呼叫端會提供 QOCINFO 結構的緩衝區，而且在不需要時必須釋放記憶體。

從針對 Windows Vista 和 Windows Server 2008 設計的應用程式開始，開發人員應該考慮使用 網路清單管理員 ，而不是此函式。

注意

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

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 sensapi.h
程式庫 Sensapi.lib
Dll Sensapi.dll

另請參閱

關於系統事件通知服務

IsNetworkAlive

QOCINFO