GetTeredoPort, funkcja

Funkcja GetTeredoPort pobiera dynamiczny numer portu UDP używany przez klienta Teredo na komputerze lokalnym.

Składnia

NETIOAPI_API GetTeredoPort(
  _Out_ USHORT *Port
);

Parametry

• Port [out]
  Wskaźnik do numeru portu UDP. Po pomyślnym powrocie ten parametr jest wypełniony numerem portu używanym przez klienta Teredo.

Wartość zwracana

getTeredoPort zwraca STATUS_SUCCESS, jeśli funkcja powiedzie się.

Jeśli funkcja nie powiedzie się, GetTeredoPort zwraca jeden z następujących kodów błędów:

Kod powrotny	Opis
STATUS_INVALID_PARAMETER	Do funkcji przekazano nieprawidłowy parametr. Ten błąd jest zwracany, jeśli wskaźnik NULL jest przekazywany w parametrze Port.
ERROR_NOT_READY	Urządzenie nie jest gotowe. Ten błąd jest zwracany, jeśli klient Teredo nie został uruchomiony na komputerze lokalnym.
STATUS_NOT_SUPPORTED	Żądanie nie jest obsługiwane. Ten błąd jest zwracany, jeśli na komputerze lokalnym nie znajduje się żaden stos IPv6.
inne	Użyj funkcji FormatMessage, aby uzyskać ciąg komunikatu dla zwróconego błędu.

Uwagi

Funkcja GetTeredoPort pobiera bieżący numer portu UDP używany przez klienta Teredo dla portu usługi Teredo. Port Teredo jest dynamiczny i może zmieniać się w dowolnym momencie ponownego uruchomienia klienta Teredo na komputerze lokalnym. Sterownik można zarejestrować, aby otrzymywać powiadomienia, gdy port usługi Teredo ulegnie zmianie, wywołując funkcję NotifyTeredoPortChange.

Klient Teredo używa również statycznego portu UDP 3544 do nasłuchiwania ruchu multiemisji wysyłanego na adres IPv4 multiemisji 224.0.0.253 zgodnie z definicją w dokumencie RFC 4380. Aby uzyskać więcej informacji, zobacz Teredo: tunelowanie IPv6 za pośrednictwem translacji adresów sieciowych (NATs) udPthrough.

Funkcja GetTeredoPort jest używana głównie przez sterowniki zapory w celu skonfigurowania odpowiednich wyjątków w celu włączenia ruchu przychodzącego i wychodzącego Teredo.

Wymagania

Platforma docelowa	universal
Wersja	Dostępne w systemie Windows Vista i nowszych wersjach systemów operacyjnych Windows.
Nagłówek	Netioapi.h (include Netioapi.h)
Biblioteka	Netio.lib
IRQL	< DISPATCH_LEVEL

Zobacz też

NotifyTeredoPortChange

NotifyStableUnicastIpAddressTable