Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |