INetworkCostManager：：GetDataPlanStatus 方法 (netlistmgr.h)

GetDataPlanStatus 會擷取整個機器因特網連線的數據計劃狀態，或連線上路由至特定目的地的第一個躍點。如果未指定 IPv4/IPv6 位址，這個方法會傳回用於全機器因特網連線之連線的數據計劃狀態。

語法

HRESULT GetDataPlanStatus(
  [out] NLM_DATAPLAN_STATUS *pDataPlanStatus,
  [in]  NLM_SOCKADDR        *pDestIPAddr
);

[out] pDataPlanStatus

NLM_DATAPLAN_STATUS 結構的指標，描述用來路由傳送至目的地之聯機的相關數據計劃狀態。如果 destIPAddr 指定通道位址，則會傳回介面堆疊中的第一個可用數據計劃狀態。

[in] pDestIPAddr

包含目的地 IPv4/IPv6 或通道位址的NLM_SOCKADDR 結構。如果為 NULL，這個方法會傳回與用於電腦因特網連線的慣用連線相關聯的成本。

傳回成功時S_OK，否則會傳回 HRESULT 錯誤碼。

傳回碼	Description
E_POINTER	pDataPlanStatus 為 NULL。
E_PENDING	判斷用來路由傳送至目的地的介面
E_INVALIDARG	destIPAddr 指定的目的地地址無效。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)	不支援此要求。如果本機計算機上沒有IPv4或IPv6堆棧，但已由 destIPAddr 指定 IPv4 或 IPv6 位址，就會傳回此錯誤。
HRESULT_FROM_WIN32 (ERROR_NO_NETWORK)	網路連線目前無法使用。