fungsi setipv4sourcefilter (ws2tcpip.h)

Artikel
08/28/2023

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
WSAENOBUFS	Ruang buffer tidak cukup tersedia.
WSAENOTSOCK	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