INetworkCostManager ::GetCost, méthode (netlistmgr.h)

Article
02/29/2024

La méthode GetCost récupère le coût actuel d’une connexion Internet à l’échelle de l’ordinateur ou du premier tronçon de routage vers une destination spécifique sur une connexion. Si destIPaddr a la valeur NULL, cette méthode retourne plutôt le coût du réseau utilisé pour la connectivité Internet à l’échelle de l’ordinateur.

Syntaxe

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

Paramètres

[out] pCost

Valeur DWORD qui indique le coût de la connexion. Les 16 bits les plus bas représentent le niveau de coût, et les 16 bits les plus élevés représentent les indicateurs. Les valeurs possibles sont définies par l’énumération NLM_CONNECTION_COST .

[in] pDestIPAddr

Structure NLM_SOCKADDR contenant l’adresse IPv4/IPv6 de destination. Si la valeur est NULL, cette méthode retourne à la place le coût associé à la connexion préférée utilisée pour la connectivité Internet de l’ordinateur.

Valeur retournée

Retourne S_OK en cas de réussite, sinon un code d’erreur HRESULT est retourné.

Code de retour	Description
E_POINTER	pCost a la valeur NULL
E_PENDING	Détermination de l’interface utilisée pour acheminer vers la destination
E_INVALIDARG	L’adresse IPv4/IPv6 de destination spécifiée par destIPAddr n’est pas valide.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	La demande n'est pas prise en charge. Cette erreur est retournée si une pile IPv4 ou IPv6 n’est pas présente sur l’ordinateur local, mais qu’une adresse IPv4 ou IPv6 a été spécifiée par destIPAddr.
HRESULT_FROM_WIN32(ERROR_NO_NETWORK)	La connectivité réseau n’est actuellement pas disponible.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	netlistmgr.h

Voir aussi

INetworkCostManager

NLM_SOCKADDR

Partager via