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 |
|---|---|
|
Der Vorgang konnte nicht abgeschlossen werden. |
|
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. |
|
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. |
|
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 |