fonction setipv4sourcefilter (ws2tcpip.h)

Article
03/04/2024

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

Syntaxe

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

Paramètres

[in] Socket

Descripteur qui identifie un socket multidiffusion.

[in] Interface

Adresse IPv4 locale de l’interface ou index d’interface sur lequel le groupe de multidiffusion doit être joint ou supprimé.

Cette valeur est dans l’ordre des octets réseau. Si ce membre spécifie une adresse IPv4 de 0.0.0.0, l’interface de multidiffusion IPv4 par défaut est utilisée.

Toute adresse IP dans le bloc 0.x.x.x (premier octet de 0) à l’exception de l’adresse IPv4 0.0.0.0 est traitée comme un index d’interface. Un index d’interface est un nombre 24 bits et le bloc d’adresse IPv4 0.0.0/8 n’est pas utilisé (cette plage est réservée).

Utiliser un index d’interface de 1 serait identique à une adresse IP de 0.0.0.1.

[in] Group

Adresse IPv4 du groupe de multidiffusion.

[in] FilterMode

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

[in] SourceCount

Nombre d’adresses sources dans la mémoire tampon pointée vers 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, setipv4sourcefilter 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 tampon est insuffisant.
WSAENOTSOCK	Le descripteur n’est pas un socket.

Remarques

La fonction inline setipv4sourcefilter est utilisée pour définir l’état du filtre multidiffusion pour un socket IPv4.

Cette fonction fait partie des extensions d’interface de socket pour les filtres sources 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 du Store Windows Phone 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