Bagikan melalui

Fungsi GetTeredoPort (netioapi.h)

  • Artikel

Fungsi GetTeredoPort mengambil nomor port UDP dinamis yang digunakan oleh klien Teredo di komputer lokal.

Sintaks

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetTeredoPort(
  [out] USHORT *Port
);

Parameter

[out] Port

Penunjuk ke nomor port UDP. Pada pengembalian yang berhasil, parameter ini akan diisi dengan nomor port yang digunakan oleh klien Teredo.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan NO_ERROR.

Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.

Menampilkan kode Deskripsi
ERROR_INVALID_PARAMETER
 Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika penunjuk NULL diteruskan dalam parameter Port .
ERROR_NOT_READY
 Perangkat belum siap. Kesalahan ini dikembalikan jika klien Teredo tidak dimulai di komputer lokal.
ERROR_NOT_SUPPORTED
 Permintaan tidak didukung. Kesalahan ini dikembalikan jika tidak ada tumpukan IPv6 di komputer lokal.
Lainnya
 Gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Keterangan

Fungsi GetTeredoPort didefinisikan pada Windows Vista dan yang lebih baru.

Fungsi GetTeredoPort mengambil nomor port UDP saat ini yang digunakan oleh klien Teredo untuk port layanan Teredo. Port Teredo bersifat dinamis dan dapat berubah kapan saja klien Teredo dimulai ulang di komputer lokal. Aplikasi dapat mendaftar untuk diberi tahu ketika port layanan Teredo berubah dengan memanggil fungsi NotifyTeredoPortChange .

Klien Teredo juga menggunakan port UDP statis 3544 untuk mendengarkan lalu lintas multicast yang dikirim pada alamat IPv4 multicast 224.0.0.253 seperti yang ditentukan dalam RFC 4380. Untuk informasi selengkapnya, lihat http://www.ietf.org/rfc/rfc4380.txt.

Fungsi GetTeredoPort digunakan terutama oleh aplikasi firewall untuk mengonfigurasi pengecualian yang sesuai untuk memungkinkan lalu lintas Teredo masuk dan keluar.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header netioapi.h (termasuk Iphlpapi.h)
Pustaka Iphlpapi.lib
DLL Iphlpapi.dll

Lihat juga

NotifyStableUnicastIpAddressTable

NotifyTeredoPortChange