Metodo INetworkCostManager::GetCost (netlistmgr.h)

  • Articolo

Il metodo GetCost recupera il costo corrente di una connessione Internet a livello di computer o il primo hop del routing a una destinazione specifica in una connessione. Se destIPaddr è NULL, questo metodo restituisce invece il costo della rete utilizzata per la connettività Internet a livello di computer.

Sintassi

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

Parametri

[out] pCost

Valore DWORD che indica il costo della connessione. I 16 bit più bassi rappresentano il livello di costo e i 16 bit più alti rappresentano i flag. I valori possibili sono definiti dall'enumerazione NLM_CONNECTION_COST .

[in] pDestIPAddr

Struttura NLM_SOCKADDR contenente l'indirizzo IPv4/IPv6 di destinazione. Se NULL, questo metodo restituirà invece il costo associato alla connessione preferita usata 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
 pCost è NULL
E_PENDING
 Determinare attualmente l'interfaccia usata per instradare alla destinazione
E_INVALIDARG
 L'indirizzo IPv4/IPv6 di destinazione specificato da destIPAddr non è valido.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 La richiesta non è supportata. Questo errore viene restituito se non è presente uno stack IPv4 o IPv6 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