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

El método GetCost recupera el costo actual de 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 destIPaddr es NULL, este método devuelve en su lugar el costo de la red utilizada para la conectividad a Internet en toda la máquina.

Sintaxis

HRESULT GetCost(
  [out] DWORD        *pCost,
  [in]  NLM_SOCKADDR *pDestIPAddr
);

Parámetros

[out] pCost

Valor DWORD que indica el costo de la conexión. Los 16 bits más bajos representan el nivel de costo y los 16 bits más altos representan las marcas. Los valores posibles se definen mediante la enumeración NLM_CONNECTION_COST .

[in] pDestIPAddr

Estructura de NLM_SOCKADDR que contiene la dirección IPv4/IPv6 de destino. Si es NULL, este método devolverá en su lugar el costo asociado a la conexión preferida que se usa 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	pCost es NULL
E_PENDING	Determinar actualmente la interfaz usada para enrutar al destino
E_INVALIDARG	La dirección IPv4/IPv6 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