GetTeredoPort işlevi

GetTeredoPort işlevi, Teredo istemcisinin yerel bilgisayarda kullandığı dinamik UDP bağlantı noktası numarasını alır.

Sözdizimi

NETIOAPI_API GetTeredoPort(
  _Out_ USHORT *Port
);

Parametre

• Bağlantı Noktası [out]
  UDP bağlantı noktası numarasının işaretçisi. Başarılı dönüşte, bu parametre Teredo istemcisinin kullandığı bağlantı noktası numarasıyla doldurulur.

Dönüş değeri

GetTeredoPort, işlev başarılı olursa STATUS_SUCCESS döndürür.

İşlev başarısız olursa GetTeredoPort aşağıdaki hata kodlarından birini döndürür:

İade kodu	Açıklama
STATUS_INVALID_PARAMETER	İşleve geçersiz bir parametre geçirildi. Bağlantı Noktası parametresinde NULL işaretçisi geçirilirse bu hata döndürülür.
ERROR_NOT_READY	Cihaz hazır değil. Teredo istemcisi yerel bilgisayarda başlatılmazsa bu hata döndürülür.
STATUS_NOT_SUPPORTED	İstek desteklenmiyor. Yerel bilgisayarda IPv6 yığını yoksa bu hata döndürülür.
Diğer	Döndürülen hatanın ileti dizesini almak için FormatMessage işlevini kullanın.

Açıklamalar

GetTeredoPort işlevi, Teredo istemcisinin Teredo hizmet bağlantı noktası için kullandığı geçerli UDP bağlantı noktası numarasını alır. Teredo bağlantı noktası dinamiktir ve Teredo istemcisi yerel bilgisayarda yeniden başlatıldığında değişebilir. Bir sürücü, NotifyTeredoPortChange işlevini çağırarak Teredo hizmet bağlantı noktası değiştiğinde bildirim almak üzere kaydolabilir.

Teredo istemcisi, RFC 4380'de tanımlandığı gibi çok noktaya yayın IPv4 adresi 224.0.0.253'te gönderilen çok noktaya yayın trafiğini dinlemek için statik UDP bağlantı noktası 3544'i de kullanır. Daha fazla bilgi için bkz. Teredo: UDPthrough Ağ Adresi Çevirileri (NAT)üzerinden IPv6 tüneli oluşturma.

GetTeredoPort işlevi, gelen ve giden Teredo trafiğini etkinleştirmek üzere uygun özel durumları yapılandırmak için öncelikle güvenlik duvarı sürücüleri tarafından kullanılır.

Gereksinim -leri

Hedef platform	Evrensel
Sürüm	Windows Vista ve Windows işletim sistemlerinin sonraki sürümlerinde kullanılabilir.
Üstbilgi	Netioapi.h (Netioapi.h içerir)
Kütüphane	Netio.lib
IRQL	< DISPATCH_LEVEL

Ayrıca bkz.

NotifyTeredoPortChange

NotifyStableUnicastIpAddressTable