Dela via


Funktionen GetTeredoPort

Funktionen GetTeredoPort hämtar det dynamiska UDP-portnumret som Teredo-klienten använder på en lokal dator.

Syntax

NETIOAPI_API GetTeredoPort(
  _Out_ USHORT *Port
);

Parametrar

  • Port [out]
    En pekare till UDP-portnumret. Vid lyckad retur fylls den här parametern med det portnummer som Teredo-klienten använder.

Returvärde

GetTeredoPort- returnerar STATUS_SUCCESS om funktionen lyckas.

Om funktionen misslyckas returnerar GetTeredoPort någon av följande felkoder:

Returnera kod Beskrivning
STATUS_INVALID_PARAMETER

En ogiltig parameter skickades till funktionen. Det här felet returneras om en NULL- pekare skickas i parametern Port.

ERROR_NOT_READY

Enheten är inte klar. Det här felet returneras om Teredo-klienten inte har startats på den lokala datorn.

STATUS_NOT_SUPPORTED

Begäran stöds inte. Det här felet returneras om ingen IPv6-stack finns på den lokala datorn.

Andra

Använd funktionen FormatMessage för att hämta meddelandesträngen för det returnerade felet.

Anmärkningar

Funktionen GetTeredoPort hämtar det aktuella UDP-portnumret som Teredo-klienten använder för Teredo-tjänstporten. Teredo-porten är dynamisk och kan ändras när som helst som Teredo-klienten startas om på den lokala datorn. En drivrutin kan registrera sig för att meddelas när Teredo-tjänstporten ändras genom att anropa funktionen NotifyTeredoPortChange.

Teredo-klienten använder också statisk UDP-port 3544 för att lyssna på multicast-trafik som skickas på multicast IPv4-adressen 224.0.0.253 enligt definitionen i RFC 4380. Mer information finns i Teredo: Tunneling IPv6 over UDPthrough Network Address Translations (NATs).

Funktionen GetTeredoPort används främst av brandväggsdrivrutiner för att konfigurera lämpliga undantag för att aktivera inkommande och utgående Teredo-trafik.

Krav

Målplattform

Universell

Version

Finns i Windows Vista och senare versioner av Windows-operativsystemen.

Rubrik

Netioapi.h (inkludera Netioapi.h)

Bibliotek

Netio.lib

IRQL

< DISPATCH_LEVEL

Se även

NotifyTeredoPortChange

NotifyStableUnicastIpAddressTable