Función setsourcefilter (ws2tcpip.h)

La función insertada setsourcefilter establece el estado del filtro de multidifusión para un socket IPv4 o IPv6.

Sintaxis

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

Parámetros

[in] Socket

Descriptor que identifica un socket de multidifusión.

[in] Interface

Índice de interfaz de la interfaz de multidifusión.

[in] Group

Puntero a la dirección de socket del grupo de multidifusión.

[in] GroupLength

Longitud, en bytes, de la dirección de socket a la que apunta el parámetro Group .

[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, setsourcefilter 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.

Comentarios

La función insertada setsourcefilter se usa para establecer el estado del filtro de multidifusión para un socket IPv4 o IPv6.

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

Consulte también

MULTICAST_MODE_TYPE

SOCKADDR_STORAGE

getipv4sourcefilter

getsourcefilter

setipv4sourcefilter