fungsi setipv4sourcefilter (ws2tcpip.h)
Fungsi setipv4sourcefilter sebaris mengatur status filter multicast untuk soket IPv4.
Sintaks
int setipv4sourcefilter(
[in] SOCKET Socket,
[in] IN_ADDR Interface,
[in] IN_ADDR Group,
[in] MULTICAST_MODE_TYPE FilterMode,
[in] ULONG SourceCount,
[in] const IN_ADDR *SourceList
);
Parameter
[in] Socket
Deskriptor yang mengidentifikasi soket multicast.
[in] Interface
Alamat IPv4 lokal antarmuka atau indeks antarmuka tempat grup multicast harus bergabung atau dihilangkan.
Nilai ini dalam urutan byte jaringan. Jika anggota ini menentukan alamat IPv4 0.0.0.0, antarmuka multicast IPv4 default digunakan.
Alamat IP apa pun di blok 0.x.x.x (oktet pertama 0) kecuali alamat IPv4 0.0.0.0 diperlakukan sebagai indeks antarmuka. Indeks antarmuka adalah angka 24-bit, dan blok alamat IPv4 0.0.0.0/8 tidak digunakan (rentang ini dicadangkan).
Untuk menggunakan indeks antarmuka 1 akan sama dengan alamat IP 0.0.0.1.
[in] Group
Alamat IPv4 dari grup multicast.
[in] FilterMode
Mode filter multicast untuk alamat grup multicast.
[in] SourceCount
Jumlah alamat sumber dalam buffer yang diacu oleh parameter SourceList .
[in] SourceList
Penunjuk ke buffer dengan alamat IP untuk dikaitkan dengan filter multicast.
Mengembalikan nilai
Jika berhasil, setipv4sourcefilter mengembalikan NO_ERROR (0). Setiap nilai pengembalian bukan nol menunjukkan kegagalan dan kode kesalahan tertentu dapat diambil dengan memanggil WSAGetLastError.
Kode kesalahan | Makna |
---|---|
Ruang buffer tidak cukup tersedia. | |
Deskriptor bukan soket. |
Keterangan
Fungsi setipv4sourcefilter sebaris digunakan untuk mengatur status filter multicast untuk soket IPv4.
Fungsi ini adalah bagian dari ekstensi antarmuka soket untuk filter sumber multicast yang ditentukan dalam RFC 3678. Aplikasi dapat menggunakan fungsi-fungsi ini untuk mengambil dan mengatur filter alamat sumber multicast yang terkait dengan soket.
Windows Phone 8: Fungsi ini didukung untuk aplikasi Windows Phone Store di Windows Phone 8 dan yang lebih baru.
Windows 8.1 dan Windows Server 2012 R2: Fungsi ini didukung untuk aplikasi Windows Store di Windows 8.1, Windows Server 2012 R2, dan yang lebih baru.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 8.1, Windows Vista [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows Server 2003 [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | ws2tcpip.h |
Pustaka | Ws2_32.lib |
DLL | Ws2_32.dll |