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

Artigo
03/05/2024

O GetDataPlanStatus recupera o plano de dados status para uma conexão de Internet em todo o computador ou o primeiro salto de roteamento para um destino específico em uma conexão. Se um endereço IPv4/IPv6 não for especificado, esse método retornará o plano de dados status da conexão usada para conectividade com a Internet em todo o computador.

Sintaxe

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

Parâmetros

[out] pDataPlanStatus

Ponteiro para uma estrutura NLM_DATAPLAN_STATUS que descreve o plano de dados status associado a uma conexão usada para rotear para um destino. Se destIPAddr especificar um endereço de túnel, o primeiro plano de dados disponível status na pilha de interface será retornado.

[in] pDestIPAddr

Uma estrutura NLM_SOCKADDR que contém o IPv4/IPv6 de destino ou o endereço de túnel. 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 em caso de êxito; caso contrário, um código de erro HRESULT é retornado.

Código de retorno	Descrição
E_POINTER	pDataPlanStatus é NULL.
E_PENDING	Determinando a interface usada para rotear para o destino
E_INVALIDARG	O endereço 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)	Atualmente, 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