setsourcefilter-Funktion (ws2tcpip.h)

Artikel
03/13/2024

Die Inlinefunktion setsourcefilter legt den Multicastfilterstatus für einen IPv4- oder IPv6-Socket fest.

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

Parameter

[in] Socket

Ein Deskriptor, der einen Multicastsocket identifiziert.

[in] Interface

Der Schnittstellenindex der Multicastschnittstelle.

[in] Group

Ein Zeiger auf die Socketadresse der Multicastgruppe.

[in] GroupLength

Die Länge der Socketadresse in Bytes, auf die der Group-Parameter verweist.

[in] FilterMode

Der Multicastfiltermodus für die Multicastgruppenadresse.

[in] SourceCount

Die Anzahl der Quelladressen im Puffer, auf die der SourceList-Parameter verweist.

[in] SourceList

Ein Zeiger auf einen Puffer mit den IP-Adressen, die dem Multicastfilter zugeordnet werden sollen.

Rückgabewert

Bei Erfolg gibt setsourcefilter NO_ERROR (0) zurück. Jeder Rückgabewert ungleich null gibt einen Fehler an, und ein bestimmter Fehlercode kann durch Aufrufen von WSAGetLastError abgerufen werden.

Fehlercode	Bedeutung
WSAENOBUFS	Es ist nicht genügend Pufferspeicher verfügbar.
WSAENOTSOCK	Der Deskriptor ist kein Socket.

Hinweise

Die Setsourcefilter-Inlinefunktion wird verwendet, um den Multicastfilterstatus für einen IPv4- oder IPv6-Socket festzulegen.

Diese Funktion ist Teil der Socketschnittstellenerweiterungen für Multicastquellenfilter, die in RFC 3678 definiert sind. Eine App kann diese Funktionen verwenden, um die Multicast-Quelladressfilter abzurufen und festzulegen, die einem Socket zugeordnet sind.

Windows Phone 8: Diese Funktion wird für Windows Phone Store-Apps ab Windows Phone 8 unterstützt.

Windows 8.1 und Windows Server 2012 R2: Diese Funktion wird für Windows Store-Apps auf Windows 8.1, Windows Server 2012 R2 und höher unterstützt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1, Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	ws2tcpip.h
Bibliothek	Ws2_32.lib
DLL	Ws2_32.dll

Weitere Informationen