GetTeredoPort-Funktion (netioapi.h)
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 |