GetBestInterface-Funktion (iphlpapi.h)

Die GetBestInterface-Funktion ruft den Index der Schnittstelle ab, die die beste Route zur angegebenen IPv4-Adresse aufweist.

Syntax

IPHLPAPI_DLL_LINKAGE DWORD GetBestInterface(
  [in]  IPAddr dwDestAddr,
  [out] PDWORD pdwBestIfIndex
);

Parameter

[in] dwDestAddr

Die Ziel-IPv4-Adresse, für die die Schnittstelle abgerufen werden soll, die die beste Route hat, in Form einer IPAddr-Struktur .

[out] pdwBestIfIndex

Ein Zeiger auf eine DWORD-Variable , die den Index der Schnittstelle empfängt, die die beste Route zu der von dwDestAddr angegebenen IPv4-Adresse aufweist.

Zurückgegebener Wert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Rückgabecode Description
ERROR_CAN_NOT_COMPLETE
 Der Vorgang konnte nicht abgeschlossen werden.
ERROR_INVALID_PARAMETER
 An die Funktion wurde ein ungültiger Parameter übergeben. Dieser Fehler wird zurückgegeben, wenn ein NULL-Zeiger im parameter pdwBestIfIndex übergeben wird oder wenn der pdwBestIfIndex auf den Speicher verweist, der nicht geschrieben werden kann.
ERROR_NOT_SUPPORTED
 Die Anforderung wird nicht unterstützt. Dieser Fehler wird zurückgegeben, wenn sich kein IPv4-Stapel auf dem lokalen Computer befindet.
Andere
 Verwenden Sie die FormatMessage-Funktion , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

Die GetBestInterface-Funktion funktioniert nur mit IPv4-Adressen. Für die Verwendung mit IPv6-Adressen muss getBestInterfaceEx verwendet werden.

Informationen zum IPAddr-Datentyp finden Sie unter Windows Datentypen. Um eine IP-Adresse zwischen gepunkteter Dezimalnotation und IPAddr-Format zu konvertieren, verwenden Sie die funktionen inet_addr und inet_ntoa .

Auf Windows Vista und höher wird der parameter pdwBestIfIndex intern von IP-Hilfsprogramm als Zeiger auf einen Datentyp NET_IFINDEX behandelt.

Requirements

Anforderung Wert
Mindestens unterstützter Client Windows 2000 Professional [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Header iphlpapi.h
Library Iphlpapi.lib
DLL Iphlpapi.dll

Siehe auch

GetBestInterfaceEx

GetBestRoute

IP-Hilfsfunktionsreferenz

Startseite des IP-Hilfsprogramms

IPAddr

MIB_BEST_IF

Windows-Datentypen

  • Zuletzt aktualisiert um