Auf Englisch lesen

Freigeben über


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

Weitere Informationen

NotifyTeredoPortChange

NotifyStableUnicastIpAddressTable