Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

setsourcefilter function

The setsourcefilter inline function sets the multicast filter state for an IPv4 or IPv6 socket.

Syntax


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

Parameters

Socket [in]

A descriptor that identifies a multicast socket.

Interface [in]

The interface index of the multicast interface.

Group [in]

A pointer to the socket address of the multicast group.

GroupLength [in]

The length, in bytes, of the socket address pointed to by the Group parameter.

FilterMode [in]

The multicast filter mode for the multicast group address.

SourceCount [in]

The number of source addresses in the buffer pointed to by the SourceList parameter.

SourceList [in]

A pointer to a buffer with the IP addresses to associate with the multicast filter.

Return value

On success, setsourcefilter returns NO_ERROR (0). Any nonzero return value indicates failure and a specific error code can be retrieved by calling WSAGetLastError.

Error codeMeaning
WSAENOBUFS

Insufficient buffer space is available.

WSAENOTSOCK

The descriptor is not a socket.

 

Remarks

The setsourcefilter inline function is used to set the multicast filter state for an IPv4 or IPv6 socket.

This function is part of socket interface extensions for multicast source filters defined in RFC 3678. An app can use these functions to retrieve and set the multicast source address filters associated with a socket.

Windows Phone 8: This function is supported for Windows Phone Store apps on Windows Phone 8 and later.

Windows 8.1 and Windows Server 2012 R2: This function is supported for Windows Store apps on Windows 8.1, Windows Server 2012 R2, and later.

Requirements

Minimum supported client

Windows 8.1, Windows Vista [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2003 [desktop apps | Windows Store apps]

Minimum supported phone

Windows Phone 8

Header

Ws2tcpip.h

Library

Ws2_32.lib

DLL

Ws2_32.dll

See also

getipv4sourcefilter
getsourcefilter
MULTICAST_MODE_TYPE
setipv4sourcefilter
SOCKADDR_STORAGE

 

 

Show:
© 2017 Microsoft