GetTeredoPort függvény

A GetTeredoPort függvény lekéri a Teredo-ügyfél által a helyi számítógépen használt dinamikus UDP-portszámot.

Szintaxis

NETIOAPI_API GetTeredoPort(
  _Out_ USHORT *Port
);

Paraméterek

  • port [ki]
    Mutató az UDP-portszámra. Sikeres visszatérés esetén ez a paraméter a Teredo-ügyfél által használt portszámmal lesz kitöltve.

Visszaadott érték

GetTeredoPort STATUS_SUCCESS ad vissza, ha a függvény sikeres.

Ha a függvény meghiúsul, GetTeredoPort a következő hibakódok egyikét adja vissza:

Kód visszaadása Leírás
STATUS_INVALID_PARAMETER

Érvénytelen paraméter lett átadva a függvénynek. Ez a hiba akkor jelenik meg, ha egy NULL mutatót ad át a Port paraméterben.

ERROR_NOT_READY

Az eszköz nem áll készen. Ez a hiba akkor jelenik meg, ha a Teredo-ügyfél nem indul el a helyi számítógépen.

STATUS_NOT_SUPPORTED

A kérés nem támogatott. Ez a hiba akkor jelenik meg, ha nem található IPv6-verem a helyi számítógépen.

Egyéb

A FormatMessage függvénnyel szerezze be a visszaadott hiba üzenetsztringét.

Megjegyzések

A GetTeredoPort függvény lekéri a Teredo-ügyfél által a Teredo szolgáltatásporthoz használt aktuális UDP-portszámot. A Teredo-port dinamikus, és bármikor megváltozhat, amikor a Teredo-ügyfél újraindul a helyi számítógépen. Az illesztőprogramok a NotifyTeredoPortChange függvény meghívásával regisztrálhatnak, hogy értesítést kapnak a Teredo szolgáltatásport változásairól.

A Teredo-ügyfél a 3544-as statikus UDP-portot is használja az RFC 4380-ban meghatározott csoportos küldésű IPv4-cím 224.0.0.253-as címére küldött csoportos küldésű forgalom figyeléséhez. További információ: Teredo: Az IPv6 bújtatása UDPthrough hálózati címfordítások (NAT-k).

A GetTeredoPort függvényt elsősorban a tűzfalillesztők használják a bejövő és kimenő Teredo-forgalom engedélyezéséhez szükséges kivételek konfigurálásához.

Követelmények

Célplatform

Univerzális

Verzió

Elérhető a Windows Vista és a Windows operációs rendszerek újabb verzióiban.

Fejléc

Netioapi.h (netioapi.h)

Könyvtár

Netio.lib

IRQL

< DISPATCH_LEVEL

Lásd még:

NotifyTeredoPortChange

NotifyStableUnicastIpAddressTable