Metodo INetworkCostManager::GetDataPlanStatus (netlistmgr.h)

  • Articolo

GetDataPlanStatus recupera lo stato del piano dati per una connessione Internet a livello di computer o il primo hop del routing a una destinazione specifica in una connessione. Se non viene specificato un indirizzo IPv4/IPv6, questo metodo restituisce lo stato del piano dati della connessione utilizzata per la connettività Internet a livello di computer.

Sintassi

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

Parametri

[out] pDataPlanStatus

Puntatore a una struttura NLM_DATAPLAN_STATUS che descrive lo stato del piano dati associato a una connessione utilizzata per il routing a una destinazione. Se destIPAddr specifica un indirizzo del tunnel, viene restituito il primo stato del piano dati disponibile nello stack di interfacce.

[in] pDestIPAddr

Struttura NLM_SOCKADDR contenente l'indirizzo IPv4/IPv6 o il tunnel di destinazione. Se NULL, questo metodo restituisce il costo associato alla connessione preferita utilizzata per la connettività Internet del computer.

Valore restituito

Restituisce S_OK in caso di esito positivo. In caso contrario, viene restituito un codice di errore HRESULT.

Codice restituito Descrizione
E_POINTER
 pDataPlanStatus è NULL.
E_PENDING
 Determinazione dell'interfaccia usata per il routing alla destinazione
E_INVALIDARG
 L'indirizzo di destinazione specificato da destIPAddr non è valido.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 La richiesta non è supportata. Questo errore viene restituito se uno stack IPv4 o IPv6 non è presente nel computer locale, ma un indirizzo IPv4 o IPv6 è stato specificato da destIPAddr.
HRESULT_FROM_WIN32(ERROR_NO_NETWORK)
 La connettività di rete non è attualmente disponibile.

Requisiti

Requisito Valore
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Nessuno supportato
Piattaforma di destinazione Windows
Intestazione netlistmgr.h

Vedi anche

INetworkCostManager

NLM_SOCKADDR