Partager via


GetNetworkConnectivityHintForInterface, fonction (netioapi.h)

Récupère le niveau et le coût de la connectivité réseau pour l’interface spécifiée.

Syntaxe

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetNetworkConnectivityHintForInterface(
  [in]  NET_IFINDEX                  InterfaceIndex,
  [out] NL_NETWORK_CONNECTIVITY_HINT *ConnectivityHint
);

Paramètres

[in] InterfaceIndex

Valeur de type NET_IFINDEX représentant l’index de l’interface pour laquelle récupérer des informations de connectivité.

[out] ConnectivityHint

Pointeur vers une valeur de type NL_NETWORK_CONNECTIVITY_HINT. La fonction définit cette valeur sur le niveau de connectivité et les indicateurs de coût pour l’interface spécifiée.

Valeur retournée

En mode utilisateur, retourne NO_ERROR en cas de réussite et un code d’erreur Win32 en cas d’échec. En mode noyau, retourne STATUS_SUCCESS en cas de réussite et un code d’erreur NTSTATUS en cas d’échec.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 2004 (10.0 ; Build 19041)
Serveur minimal pris en charge Windows Server, version 2004 (10.0 ; Build 19041)
Plateforme cible Windows
En-tête netioapi.h (include Iphlpapi.h)
Bibliothèque Iphlpapi.lib
DLL Iphlpapi.dll