Fungsi GetMulticastIpAddressTable (netioapi.h)
Fungsi GetMulticastIpAddressTable mengambil tabel alamat IP multicast di komputer lokal.
Sintaks
IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetMulticastIpAddressTable(
[in] ADDRESS_FAMILY Family,
[out] PMIB_MULTICASTIPADDRESS_TABLE *Table
);
Parameter
[in] Family
Keluarga alamat yang akan diambil.
Nilai yang mungkin untuk keluarga alamat tercantum dalam file header Winsock2.h . Perhatikan bahwa nilai untuk keluarga alamat AF_ dan konstanta keluarga protokol PF_ identik (misalnya, AF_INET dan PF_INET), sehingga konstanta mana pun dapat digunakan.
Pada Windows SDK yang dirilis untuk Windows Vista dan yang lebih baru, organisasi file header telah berubah dan nilai yang mungkin untuk anggota ini ditentukan dalam file header Ws2def.h . Perhatikan bahwa file header Ws2def.h secara otomatis disertakan dalam Winsock2.h, dan tidak boleh digunakan secara langsung.
Nilai yang saat ini didukung adalah AF_INET, AF_INET6, dan AF_UNSPEC.
[out] Table
Penunjuk ke struktur MIB_MULTICASTIPADDRESS_TABLE yang berisi tabel entri alamat IP anycast di komputer lokal.
Mengembalikan nilai
Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR.
Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika penunjuk NULL diteruskan dalam parameter Tabel atau parameter Family tidak ditentukan sebagai AF_INET, AF_INET6, atau AF_UNSPEC. |
|
Sumber daya memori tidak cukup tersedia untuk menyelesaikan operasi. |
|
Tidak ada entri alamat IP anycast seperti yang ditentukan dalam parameter Family yang ditemukan. |
|
Permintaan tidak didukung. Kesalahan ini dikembalikan jika tidak ada tumpukan IPv4 di komputer lokal dan AF_INET ditentukan dalam parameter Keluarga . Kesalahan ini juga dikembalikan jika tidak ada tumpukan IPv6 di komputer lokal dan AF_INET6 ditentukan dalam parameter Keluarga . Kesalahan ini juga dikembalikan pada versi Windows di mana fungsi ini tidak didukung. |
|
Gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan. |
Keterangan
Fungsi GetMulticastIpAddressTable didefinisikan pada Windows Vista dan yang lebih baru.
The
Fungsi GetMulticastIpAddressTable menghitung alamat IP multicast pada sistem lokal dan mengembalikan informasi ini dalam struktur MIB_MULTICASTIPADDRESS_TABLE .
Entri alamat IP multicast dikembalikan dalam struktur MIB_MULTICASTIPADDRESS_TABLE dalam buffer yang ditujukkan oleh parameter Tabel . Struktur MIB_MULTICASTIPADDRESS_TABLE berisi jumlah entri alamat IP multicast dan array struktur MIB_MULTICASTIPADDRESS_ROW untuk setiap entri alamat IP multicast. Ketika struktur yang dikembalikan ini tidak lagi diperlukan, kosongkan memori dengan memanggil FreeMibTable.
Parameter Keluarga harus diinisialisasi ke AF_INET, AF_INET6, atau AF_UNSPEC.
Perhatikan bahwa struktur MIB_MULTICASTIPADDRESS_TABLE yang dikembalikan yang ditunjukkan oleh parameter Tabel mungkin berisi pengisi untuk perataan antara anggota NumEntries dan entri array MIB_MULTICASTIPADDRESS_ROW pertama di anggota Tabel dari struktur MIB_MULTICASTIPADDRESS_TABLE . Padding untuk perataan mungkin juga ada di antara entri array MIB_MULTICASTIPADDRESS_ROW . Setiap akses ke entri array MIB_MULTICASTIPADDRESS_ROW harus mengasumsikan padding mungkin ada.
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 |