Share via

GetTeredoPort-Funktion (netioapi.h)

  • Artikel

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
ERROR_INVALID_PARAMETER
 Es wurde ein ungültiger Parameter 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.
ERROR_NOT_SUPPORTED
 Die Anforderung wird nicht unterstützt. Dieser Fehler wird zurückgegeben, wenn sich auf dem lokalen Computer kein IPv6-Stapel befindet.
Andere
 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

Weitere Informationen

NotifyStableUnicastIpAddressTable

NotifyTeredoPortChange