fungsi setsourcefilter (ws2tcpip.h)

Artikel
03/15/2023

Fungsi setsourcefilter sebaris mengatur status filter multicast untuk soket IPv4 atau IPv6.

Sintaks

int setsourcefilter(
  [in] SOCKET                 Socket,
  [in] ULONG                  Interface,
  [in] const SOCKADDR         *Group,
  [in] int                    GroupLength,
  [in] MULTICAST_MODE_TYPE    FilterMode,
  [in] ULONG                  SourceCount,
  [in] const SOCKADDR_STORAGE *SourceList
);

Parameter

[in] Socket

Deskriptor yang mengidentifikasi soket multicast.

[in] Interface

Indeks antarmuka antarmuka multicast.

[in] Group

Penunjuk ke alamat soket grup multicast.

[in] GroupLength

Panjang, dalam byte, dari alamat soket yang ditujukan oleh parameter Grup .

[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, setsourcefilter 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 setsourcefilter sebaris digunakan untuk mengatur status filter multicast untuk soket IPv4 atau IPv6.

Fungsi ini adalah bagian dari ekstensi antarmuka soket untuk filter sumber multicast yang ditentukan dalam RFC 3678. Aplikasi dapat menggunakan 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

Lihat juga

Bagikan melalui