INetworkCostManager：：GetDataPlanStatus 方法 (netlistmgr.h)

GetDataPlanStatus 检索计算机范围的 Internet 连接或路由到连接上特定目标的第一跃点的数据计划状态。如果未指定 IPv4/IPv6 地址，此方法将返回用于计算机范围的 Internet 连接的数据计划状态。

语法

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

[out] pDataPlanStatus

指向 NLM_DATAPLAN_STATUS 结构的指针，该结构描述与用于路由到目标的连接关联的数据计划状态。如果 destIPAddr 指定隧道地址，则返回接口堆栈中的第一个可用数据计划状态。

[in] pDestIPAddr

包含目标 IPv4/IPv6 或隧道地址的NLM_SOCKADDR 结构。如果为 NULL，则此方法返回与用于计算机 Internet 连接的首选连接关联的成本。

成功时返回S_OK，否则返回 HRESULT 错误代码。

返回代码	说明
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)	网络连接当前不可用。