GetBestInterfaceEx-Funktion (iphlpapi.h)

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

Syntax

IPHLPAPI_DLL_LINKAGE DWORD GetBestInterfaceEx(
  [in]  sockaddr *pDestAddr,
  [out] PDWORD   pdwBestIfIndex
);

Parameter

[in] pDestAddr

Die IPv6- oder IPv4-Zieladresse, für die die Schnittstelle mit der besten Route in Form einer sockaddr-Struktur abgerufen werden soll.

[out] pdwBestIfIndex

Ein Zeiger auf den Index der Schnittstelle mit der besten Route zu der von pDestAddr angegebenen IPv6- oder IPv4-Adresse.

Rückgabewert

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	Beschreibung
ERROR_CAN_NOT_COMPLETE	Der Vorgang konnte nicht abgeschlossen werden.
ERROR_INVALID_PARAMETER	Es wurde ein ungültiger Parameter an die Funktion übergeben. Dieser Fehler wird zurückgegeben, wenn ein NULL-Zeiger im pdwBestIfIndex-Parameter übergeben wird oder wenn die Parameter pDestAddr oder pdwBestIfIndex auf den Arbeitsspeicher verweisen, auf den nicht zugegriffen werden kann. Dieser Fehler kann auch zurückgegeben werden, wenn der pdwBestIfIndex-Parameter auf den Arbeitsspeicher verweist, der nicht in den 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 und im Parameter pDestAddr eine IPv4-Adresse angegeben wurde oder sich kein IPv6-Stapel auf dem lokalen Computer befindet und im Parameter pDestAddr eine IPv6-Adresse angegeben wurde.
Andere	Verwenden Sie die FormatMessage-Funktion , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

Die GetBestInterfaceEx-Funktion unterscheidet sich von der GetBestInterface-Funktion darin, dass sie mit IPv4- oder IPv6-Adressen verwendet werden kann.

Das Family-Mitglied der sockaddr-Struktur, auf die der pDestAddr-Parameter verweist, muss auf einen der folgenden Werte festgelegt werden: AF_INET oder AF_INET6.

Unter Windows Vista und höher wird der pdwBestIfIndex-Parameter intern vom IP-Hilfsprogramm als Zeiger auf einen NET_IFINDEX-Datentyp behandelt.

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	iphlpapi.h
Bibliothek	Iphlpapi.lib
DLL	Iphlpapi.dll

Weitere Informationen

GetBestInterface

Ip-Hilfsfunktionsreferenz

Startseite des IP-Hilfsprogrammes

MIB_BEST_IF

sockaddr