GetTeredoPort-Funktion
Die GetTeredoPort-Funktion ruft die dynamische UDP-Portnummer ab, die der Teredo-Client auf einem lokalen Computer verwendet.
Syntax
NETIOAPI_API GetTeredoPort(
_Out_ USHORT *Port
);
Parameter
- Port [out]
Ein Zeiger auf die UDP-Portnummer. Bei erfolgreicher Rückgabe wird dieser Parameter mit der Portnummer gefüllt, die der Teredo-Client verwendet.
Rückgabewert
GetTeredoPort gibt STATUS_SUCCESS zurück, wenn die Funktion erfolgreich ist.
Wenn die Funktion fehlschlägt, gibt GetTeredoPort einen der folgenden Fehlercodes zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_INVALID_PARAMETER | Ein ungültiger Parameter wurde an die Funktion übergeben. Dieser Fehler wird zurückgegeben, wenn ein NULL-Zeiger im Port-Parameter übergeben wird. |
| ERROR_NOT_READY | Das Gerät ist nicht bereit. Dieser Fehler wird zurückgegeben, wenn der Teredo-Client nicht auf dem lokalen Computer gestartet wird. |
| STATUS_NOT_SUPPORTED | Die Anforderung wird nicht unterstützt. Dieser Fehler wird zurückgegeben, wenn sich kein IPv6-Stapel auf dem lokalen Computer befindet. |
| Andere | Verwenden Sie die FormatMessage-Funktion, um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen. |
Hinweise
Die GetTeredoPort-Funktion ruft die aktuelle UDP-Portnummer ab, die der Teredo-Client für den Teredo-Dienstport verwendet. Der Teredo-Port ist dynamisch und kann sich jederzeit ändern, wenn der Teredo-Client auf dem lokalen Computer neu gestartet wird. Ein Treiber kann sich registrieren, um benachrichtigt zu werden, wenn sich der Teredo-Dienstport ändert, indem die NotifyTeredoPortChange-Funktion aufgerufen wird.
Der Teredo-Client verwendet auch statische UDP-Port 3544 zum Überwachen von Multicast-Datenverkehr, der auf Multicast-IPv4-Adresse 224.0.0.253 gemäß RFC 4380 gesendet wird. Weitere Informationen finden Sie unter Teredo: Tunneln von IPv6 über UDPthrough Network Address Translation (NATs).
Die GetTeredoPort-Funktion wird hauptsächlich von Firewalltreibern verwendet, um die entsprechenden Ausnahmen zu konfigurieren, um eingehenden und ausgehenden Teredo-Datenverkehr zu aktivieren.
Anforderungen
Zielplattform |
Universell |
Version |
Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
Header |
Netioapi.h (Netioapi.h einschließen) |
Bibliothek |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |