funzione setipv4sourcefilter (ws2tcpip.h)
La funzione inline setipv4sourcefilter imposta lo stato del filtro multicast per un socket IPv4.
Sintassi
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
);
Parametri
[in] Socket
Descrittore che identifica un socket multicast.
[in] Interface
Indirizzo IPv4 locale dell'interfaccia o dell'indice dell'interfaccia in cui deve essere aggiunto o eliminato il gruppo multicast.
Questo valore è in ordine di byte di rete. Se questo membro specifica un indirizzo IPv4 pari a 0.0.0.0,0, viene usata l'interfaccia multicast IPv4 predefinita.
Qualsiasi indirizzo IP nel blocco 0.x.x.x (primo ottetto di 0) tranne l'indirizzo IPv4 0.0.0.0.0 viene considerato come indice di interfaccia. Un indice di interfaccia è un numero a 24 bit e il blocco indirizzi IPv4 0.0.0.0/8 non viene usato (questo intervallo è riservato).
Per usare un indice di interfaccia pari a 1 sarebbe uguale a un indirizzo IP pari a 0.0.0.1.
[in] Group
Indirizzo IPv4 del gruppo multicast.
[in] FilterMode
Modalità di 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, setipv4sourcefilter 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 |
|---|---|
| Spazio buffer insufficiente disponibile. | |
| Il descrittore non è un socket. |
Commenti
La funzione inline setipv4sourcefilter viene usata per impostare lo stato del filtro multicast per un socket IPv4.
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 |