funzione setsourcefilter (ws2tcpip.h)

Articolo
03/04/2024

La funzione inline setsourcefilter imposta lo stato del filtro multicast per un socket IPv4 o IPv6.

Sintassi

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

Parametri

[in] Socket

Descrittore che identifica un socket multicast.

[in] Interface

Indice dell'interfaccia dell'interfaccia multicast.

[in] Group

Puntatore all'indirizzo socket del gruppo multicast.

[in] GroupLength

Lunghezza, in byte, dell'indirizzo socket a cui fa riferimento il parametro Group .

[in] FilterMode

Modalità filtro multicast per l'indirizzo del gruppo multicast.

[in] SourceCount

Numero di indirizzi di origine nel buffer a cui punta il parametro SourceList .

[in] SourceList

Puntatore a un buffer con gli indirizzi IP da associare al filtro multicast.

Valore restituito

In caso di esito positivo, setsourcefilter restituisce NO_ERROR (0). Qualsiasi valore restituito diverso da zero indica l'errore e un codice di errore specifico può essere recuperato chiamando WSAGetLastError.

Codice di errore	Significato
WSAENOBUFS	Spazio buffer insufficiente disponibile.
WSAENOTSOCK	Il descrittore non è un socket.

Commenti

La funzione inline setsourcefilter viene usata per impostare lo stato del filtro multicast per un socket IPv4 o IPv6.

Questa funzione fa parte delle estensioni dell'interfaccia socket per i filtri di origine multicast definiti in RFC 3678. Un'app può usare queste funzioni per recuperare e impostare i filtri degli indirizzi di origine multicast associati a un socket.

Windows Phone 8: questa funzione è supportata per le app Windows Phone Store in Windows Phone 8 e versioni successive.

Windows 8.1 e Windows Server 2012 R2: questa funzione è supportata per le app di Windows Store in Windows 8.1, Windows Server 2012 R2 e versioni successive.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8.1, Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	ws2tcpip.h
Libreria	Ws2_32.lib
DLL	Ws2_32.dll