INetworkCostManager::GetCost 方法 (netlistmgr.h)
GetCost 方法會擷取整個電腦連線的目前成本,或路由至連線上特定目的地的第一個躍點。 如果 destIPaddr 為 NULL,此方法會改為傳回用於全計算機因特網連線的網路成本。
語法
HRESULT GetCost(
[out] DWORD *pCost,
[in] NLM_SOCKADDR *pDestIPAddr
);
參數
[out] pCost
指出連線成本的 DWORD 值。 最低16位代表成本層級,最高16位代表旗標。 可能的值是由 NLM_CONNECTION_COST 列舉所定義。
[in] pDestIPAddr
包含目的地 IPv4/IPv6 位址 的NLM_SOCKADDR 結構。 如果為 NULL,這個方法會改為傳回與用於電腦因特網連線之慣用連線相關聯的成本。
傳回值
傳回成功時S_OK,否則會傳回 HRESULT 錯誤碼。
傳回碼 | Description |
---|---|
|
pCost 為 NULL |
|
目前判斷用來路由傳送至目的地的介面 |
|
destIPAddr 指定的目的地 IPv4/IPv6 位址無效。 |
|
不支援此要求。 如果本機計算機上沒有IPv4或IPv6堆棧,但 destIPAddr 指定了 IPv4 或 IPv6 位址,就會傳回此錯誤。 |
|
網路連線目前無法使用。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | netlistmgr.h |