Share via

GetNetworkConnectivityHintForInterface-Funktion (netioapi.h)

  • Artikel

Ruft die Ebene und die Kosten der Netzwerkkonnektivität für die angegebene Schnittstelle ab.

Syntax

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

Parameter

[in] InterfaceIndex

Ein Wert vom Typ NET_IFINDEX , der den Index der Schnittstelle darstellt, für die Konnektivitätsinformationen abgerufen werden sollen.

[out] ConnectivityHint

Ein Zeiger auf einen Wert vom Typ NL_NETWORK_CONNECTIVITY_HINT. Die Funktion legt diesen Wert auf die Konnektivitätsebene und die Kostenhinweise für die angegebene Schnittstelle fest.

Rückgabewert

Im Benutzermodus gibt NO_ERROR bei Erfolg und einen Win32-Fehlercode bei Einem Fehler zurück. Im Kernelmodus gibt STATUS_SUCCESS bei Erfolg und einen NTSTATUS-Fehlercode bei Einem Fehler zurück.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 2004 (10.0; Build 19041)
Unterstützte Mindestversion (Server) Windows Server, Version 2004 (10.0; Build 19041)
Zielplattform Windows
Kopfzeile netioapi.h (include Iphlpapi.h)
Bibliothek Iphlpapi.lib
DLL Iphlpapi.dll