Fungsi LookupPersistentUdpPortReservation (iphlpapi.h)

Artikel
02/28/2024

Fungsi LookupPersistentUdpPortReservation mencari token untuk reservasi port UDP persisten untuk blok berturut-turut port TCP di komputer lokal.

Sintaks

IPHLPAPI_DLL_LINKAGE ULONG LookupPersistentUdpPortReservation(
  [in]  USHORT   StartPort,
  [in]  USHORT   NumberOfPorts,
  [out] PULONG64 Token
);

Parameter

[in] StartPort

Nomor port UDP awal dalam urutan byte jaringan.

[in] NumberOfPorts

Jumlah nomor port UDP yang dicadangkan.

[out] Token

Pointer ke token reservasi port yang dikembalikan jika fungsi berhasil.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah 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 nol diteruskan dalam parameter StartPort atau NumberOfPorts .
ERROR_NOT_FOUND	Elemen tidak ditemukan. Kesalahan ini dikembalikan jika blok port persisten yang ditentukan oleh parameter StartPort dan NumberOfPorts tidak dapat ditemukan.
Lainnya	Gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Keterangan

Fungsi LookupPersistentUdpPortReservation didefinisikan pada Windows Vista dan yang lebih baru.

Fungsi LookupPersistentUdpPortReservation digunakan untuk mencari token untuk reservasi persisten untuk blok port UDP.

Reservasi persisten untuk blok port UDP dibuat dengan panggilan ke fungsi CreatePersistentUdpPortReservation . Parameter StartPort atau NumberOfPorts yang diteruskan ke fungsi LookupPersistentUdpPortReservation harus cocok dengan nilai yang digunakan saat reservasi persisten untuk blok port TCP dibuat oleh fungsi CreatePersistentUdpPortReservation .

Jika fungsi LookupPersistentUdpPortReservation berhasil, parameter Token yang dikembalikan akan mengarah ke token untuk reservasi port persisten untuk blok port UDP. Perhatikan bahwa token untuk reservasi persisten tertentu untuk blok port TCP dapat berubah setiap kali sistem dimulai ulang.

Aplikasi dapat meminta penetapan port dari reservasi port UDP dengan membuka soket UDP, lalu memanggil fungsi WSAIoctl yang menentukan SIO_ASSOCIATE_PORT_RESERVATION IOCTL dan meneruskan token reservasi sebelum mengeluarkan panggilan ke fungsi ikat pada soket.

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	iphlpapi.h
Pustaka	Iphlpapi.lib
DLL	Iphlpapi.dll