Función setsourcefilter (ws2tcpip.h)

  • Artículo

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.

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

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

SOCKADDR_STORAGE

getipv4sourcefilter

getsourcefilter

setipv4sourcefilter