setsourcefilter, fonction (ws2tcpip.h)

Article
03/13/2024

La fonction inline setsourcefilter définit l’état du filtre de multidiffusion pour un socket IPv4 ou IPv6.

Syntaxe

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
);

Paramètres

[in] Socket

Descripteur qui identifie un socket de multidiffusion.

[in] Interface

Index d’interface de l’interface de multidiffusion.

[in] Group

Pointeur vers l’adresse de socket du groupe de multidiffusion.

[in] GroupLength

Longueur, en octets, de l’adresse de socket pointée vers le paramètre Group .

[in] FilterMode

Mode de filtre de multidiffusion pour l’adresse du groupe de multidiffusion.

[in] SourceCount

Nombre d’adresses sources dans la mémoire tampon vers laquelle pointe le paramètre SourceList .

[in] SourceList

Pointeur vers une mémoire tampon avec les adresses IP à associer au filtre de multidiffusion.

Valeur retournée

En cas de réussite, setsourcefilter retourne NO_ERROR (0). Toute valeur de retour différente de zéro indique un échec et un code d’erreur spécifique peut être récupéré en appelant WSAGetLastError.

Code d'erreur	Signification
WSAENOBUFS	L’espace de mémoire tampon est insuffisant.
WSAENOTSOCK	Le descripteur n’est pas un socket.

Remarques

La fonction inline setsourcefilter permet de définir l’état du filtre de multidiffusion pour un socket IPv4 ou IPv6.

Cette fonction fait partie des extensions d’interface de socket pour les filtres sources de multidiffusion définis dans RFC 3678. Une application peut utiliser ces fonctions pour récupérer et définir les filtres d’adresse source de multidiffusion associés à un socket.

Windows Phone 8 : cette fonction est prise en charge pour les applications Windows Phone Store sur Windows Phone 8 et versions ultérieures.

Windows 8.1 et Windows Server 2012 R2 : cette fonction est prise en charge pour les applications du Windows Store sur Windows 8.1, Windows Server 2012 R2 et versions ultérieures.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8.1, Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	ws2tcpip.h
Bibliothèque	Ws2_32.lib
DLL	Ws2_32.dll

Voir aussi