Condividi tramite


funzione setsourcefilter (ws2tcpip.h)

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

Vedi anche

MULTICAST_MODE_TYPE

SOCKADDR_STORAGE

getipv4sourcefilter

getsourcefilter

setipv4sourcefilter