Función setipv4sourcefilter (ws2tcpip.h)
La función insertada setipv4sourcefilter establece el estado de filtro de multidifusión para un socket IPv4.
Sintaxis
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
);
Parámetros
[in] Socket
Descriptor que identifica un socket de multidifusión.
[in] Interface
La dirección IPv4 local de la interfaz o el índice de interfaz en el que se debe unir o quitar el grupo de multidifusión.
Este valor está en orden de bytes de red. Si este miembro especifica una dirección IPv4 de 0.0.0.0, se usa la interfaz de multidifusión IPv4 predeterminada.
Cualquier dirección IP del bloque 0.x.x.x (primer octeto de 0), excepto la dirección IPv4 0.0.0.0, se trata como un índice de interfaz. Un índice de interfaz es un número de 24 bits y no se usa el bloque de direcciones IPv4 0.0.0.0/8 (este intervalo está reservado).
Para usar un índice de interfaz de 1 sería el mismo que una dirección IP de 0.0.0.1.
[in] Group
Dirección IPv4 del grupo de multidifusión.
[in] FilterMode
Modo de filtro de multidifusión para la dirección del grupo de multidifusión.
[in] SourceCount
Número de direcciones de origen en el búfer al que apunta el parámetro SourceList .
[in] SourceList
Puntero a un búfer con las direcciones IP que se van a asociar al filtro de multidifusión.
Valor devuelto
Si se ejecuta correctamente, setipv4sourcefilter devuelve NO_ERROR (0). Cualquier valor devuelto distinto de cero indica un error y se puede recuperar un código de error específico llamando a WSAGetLastError.
| Código de error | Significado |
|---|---|
| No hay suficiente espacio en búfer disponible. | |
| El descriptor no es un socket. |
Comentarios
La función insertada setipv4sourcefilter se usa para establecer el estado del filtro de multidifusión para un socket IPv4.
Esta función forma parte de las extensiones de interfaz de socket para los filtros de origen de multidifusión definidos en RFC 3678. Una aplicación puede usar estas funciones para recuperar y establecer los filtros de dirección de origen de multidifusión asociados a un socket.
Windows Phone 8: esta función es compatible con las aplicaciones de Windows Phone Store en Windows Phone 8 y versiones posteriores.
Windows 8.1 y Windows Server 2012 R2: esta función es compatible con las aplicaciones de la Tienda Windows en Windows 8.1, Windows Server 2012 R2 y versiones posteriores.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8.1, Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | ws2tcpip.h |
| Library | Ws2_32.lib |
| Archivo DLL | Ws2_32.dll |