Fungsi GetTeredoPort
Fungsi GetTeredoPort mengambil nomor port UDP dinamis yang digunakan klien Teredo di komputer lokal.
Sintaks
NETIOAPI_API GetTeredoPort(
_Out_ USHORT *Port
);
Parameter
- Port [keluar]
Penunjuk ke nomor port UDP. Pada pengembalian yang berhasil, parameter ini diisi dengan nomor port yang digunakan klien Teredo.
Nilai hasil
GetTeredoPort mengembalikan STATUS_SUCCESS jika fungsi berhasil.
Jika fungsi gagal, GetTeredoPort mengembalikan salah satu kode kesalahan berikut:
| Mengembalikan kode | Deskripsi |
|---|---|
| STATUS_INVALID_PARAMETER | Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika pointer NULL diteruskan dalam parameter Port . |
| ERROR_NOT_READY | Perangkat belum siap. Kesalahan ini dikembalikan jika klien Teredo tidak dimulai di komputer lokal. |
| STATUS_NOT_SUPPORTED | Permintaan tidak didukung. Kesalahan ini dikembalikan jika tidak ada tumpukan IPv6 yang terletak di komputer lokal. |
| Lainnya | Gunakan fungsi FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan. |
Keterangan
Fungsi GetTeredoPort mengambil nomor port UDP saat ini yang digunakan klien Teredo untuk port layanan Teredo. Port Teredo bersifat dinamis dan dapat berubah kapan saja klien Teredo dimulai ulang di komputer lokal. Driver 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 didefinisikan dalam RFC 4380. Untuk informasi selengkapnya, lihat Teredo: Penerowongan IPv6 melalui UDPthrough Network Address Translations (NATs).
Fungsi GetTeredoPort digunakan terutama oleh driver firewall untuk mengonfigurasi pengecualian yang sesuai untuk mengaktifkan lalu lintas Teredo masuk dan keluar.
Persyaratan
Platform target |
Universal |
Versi |
Tersedia di Windows Vista dan versi sistem operasi Windows yang lebih baru. |
Header |
Netioapi.h (termasuk Netioapi.h) |
Pustaka |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |