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 GetTeredoPort-Funktion ruft die dynamische UDP-Portnummer ab, die vom Teredo-Client auf dem lokalen Computer verwendet wird.
Syntax
IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetTeredoPort(
[out] USHORT *Port
);
Parameter
[out] Port
Ein Zeiger auf die UDP-Portnummer. Bei erfolgreicher Rückgabe wird dieser Parameter mit der Portnummer gefüllt, die vom Teredo-Client verwendet wird.
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 |
|---|---|
|
Es wurde ein ungültiger Parameter an die Funktion übergeben. Dieser Fehler wird zurückgegeben, wenn ein NULL-Zeiger im Port-Parameter übergeben wird. |
|
Das Gerät ist nicht bereit. Dieser Fehler wird zurückgegeben, wenn der Teredo-Client nicht auf dem lokalen Computer gestartet wird. |
|
Die Anforderung wird nicht unterstützt. Dieser Fehler wird zurückgegeben, wenn sich auf dem lokalen Computer kein IPv6-Stapel befindet. |
|
Verwenden Sie FormatMessage , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen. |
Hinweise
Die GetTeredoPort-Funktion ist unter Windows Vista und höher definiert.
Die GetTeredoPort-Funktion ruft die aktuelle UDP-Portnummer ab, die vom Teredo-Client für den Teredo-Dienstport verwendet wird. Der Teredo-Port ist dynamisch und kann sich jederzeit ändern, wenn der Teredo-Client auf dem lokalen Computer neu gestartet wird. Eine Anwendung kann sich registrieren, um benachrichtigt zu werden, wenn sich der Teredo-Dienstport ändert, indem sie die NotifyTeredoPortChange-Funktion aufruft .
Der Teredo-Client verwendet auch den statischen UDP-Port 3544 zum Lauschen von Multicastdatenverkehr, der an die Multicast-IPv4-Adresse 224.0.0.253 gesendet wird, wie in RFC 4380 definiert. Weitere Informationen finden Sie unter http://www.ietf.org/rfc/rfc4380.txt.
Die GetTeredoPort-Funktion wird hauptsächlich von Firewallanwendungen verwendet, um die entsprechenden Ausnahmen so zu konfigurieren, dass eingehender und ausgehender Teredodatenverkehr zugelassen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | netioapi.h (include Iphlpapi.h) |
| Bibliothek | Iphlpapi.lib |
| DLL | Iphlpapi.dll |