Método INetworkCostManager::GetDataPlanStatus (netlistmgr.h)

GetDataPlanStatus recupera el estado del plan de datos para una conexión a Internet en toda la máquina o el primer salto de enrutamiento a un destino específico en una conexión. Si no se especifica una dirección IPv4/IPv6, este método devuelve el estado del plan de datos de la conexión utilizada para la conectividad a Internet en toda la máquina.

Sintaxis

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

Parámetros

[out] pDataPlanStatus

Puntero a una estructura de NLM_DATAPLAN_STATUS que describe el estado del plan de datos asociado a una conexión que se usa para enrutar a un destino. Si destIPAddr especifica una dirección de túnel, se devuelve el primer estado del plan de datos disponible en la pila de interfaz.

[in] pDestIPAddr

Estructura de NLM_SOCKADDR que contiene la dirección IPv4/IPv6 o de túnel de destino. Si es NULL, este método devuelve el costo asociado a la conexión preferida usada para la conectividad a Internet de la máquina.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente; de lo contrario, se devuelve un código de error HRESULT.

Código devuelto	Descripción
E_POINTER	pDataPlanStatus es NULL.
E_PENDING	Determinación de la interfaz usada para enrutar al destino
E_INVALIDARG	La dirección de destino especificada por destIPAddr no es válida.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	No se admite la solicitud. Este error se devuelve si una pila IPv4 o IPv6 no está presente en el equipo local, pero se especificó una dirección IPv4 o IPv6 mediante destIPAddr.
HRESULT_FROM_WIN32(ERROR_NO_NETWORK)	La conectividad de red no está disponible actualmente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	netlistmgr.h

Consulte también

INetworkCostManager

NLM_SOCKADDR