Función setipv4sourcefilter (ws2tcpip.h)

  • Artículo

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
WSAENOBUFS
 No hay suficiente espacio en búfer disponible.
WSAENOTSOCK
 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

Consulte también

MULTICAST_MODE_TYPE

getipv4sourcefilter

getsourcefilter

in_addr

setsourcefilter