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

Artigo
02/29/2024

O método GetCost recupera o custo atual de uma conexão com a Internet em todo o computador ou o primeiro salto de roteamento para um destino específico em uma conexão. Se destIPaddr for NULL, esse método retornará o custo da rede usada para conectividade com a Internet em todo o computador.

Sintaxe

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

Parâmetros

[out] pCost

Um valor DWORD que indica o custo da conexão. Os 16 bits mais baixos representam o nível de custo e os 16 bits mais altos representam os sinalizadores. Os valores possíveis são definidos pela enumeração NLM_CONNECTION_COST .

[in] pDestIPAddr

Uma estrutura NLM_SOCKADDR que contém o endereço IPv4/IPv6 de destino. Se FOR NULL, esse método retornará o custo associado à conexão preferencial usada para conectividade com a Internet do computador.

Retornar valor

Retorna S_OK com êxito, caso contrário, um código de erro HRESULT é retornado.

Código de retorno	Descrição
E_POINTER	pCost é NULL
E_PENDING	No momento, determinar a interface usada para rotear para o destino
E_INVALIDARG	O endereço IPv4/IPv6 de destino especificado por destIPAddr é inválido.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	A solicitação não terá suporte. Esse erro será retornado se uma pilha IPv4 ou IPv6 não estiver presente no computador local, mas um endereço IPv4 ou IPv6 tiver sido especificado por destIPAddr.
HRESULT_FROM_WIN32(ERROR_NO_NETWORK)	No momento, a conectividade de rede não está disponível.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	netlistmgr.h

Confira também

INetworkCostManager

NLM_SOCKADDR

Compartilhar via