Fungsi GetUdp6Table (iphlpapi.h)

Artikel
03/04/2024

Fungsi GetUdp6Table mengambil tabel pendengar Protokol Datagram Pengguna (UDP) IPv6.

Sintaks

IPHLPAPI_DLL_LINKAGE ULONG GetUdp6Table(
  [out]     PMIB_UDP6TABLE Udp6Table,
  [in, out] PULONG         SizePointer,
  [in]      BOOL           Order
);

Parameter

[out] Udp6Table

Penunjuk ke buffer yang menerima tabel pendengar UDP IPv6 sebagai struktur MIB_UDP6TABLE .

[in, out] SizePointer

Pada input, menentukan ukuran dalam byte buffer yang diacu oleh parameter Udp6Table .

Pada output, jika buffer tidak cukup besar untuk menahan tabel pendengar yang dikembalikan, fungsi mengatur parameter ini sama dengan ukuran buffer yang diperlukan dalam byte.

[in] Order

Nilai Boolean yang menentukan apakah tabel pendengar UDP yang dikembalikan harus diurutkan. Jika parameter ini TRUE, tabel diurutkan dalam urutan:

Alamat IPv6 lokal
ID cakupan lokal
Port lokal

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_INSUFFICIENT_BUFFER	Buffer yang ditujukkan oleh parameter Udp6Table tidak cukup besar. Ukuran yang diperlukan dikembalikan dalam variabel ULONG yang ditunjukkan oleh parameter SizePointer .
ERROR_INVALID_PARAMETER	Parameter SizePointeradalah NULL, atau GetUdp6Table tidak dapat menulis ke memori yang diacu oleh parameter SizePointer .
ERROR_NOT_SUPPORTED	Fungsi ini tidak didukung pada sistem operasi yang digunakan pada sistem lokal.
Lainnya	Gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Keterangan

Fungsi GetUdp6Table ditentukan pada Windows Vista dan yang lebih baru.

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