setipv4sourcefilter-Funktion (ws2tcpip.h)

Artikel
03/04/2024

Die Inlinefunktion setipv4sourcefilter legt den Multicastfilterstatus für einen IPv4-Socket fest.

Syntax

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

Parameter

[in] Socket

Ein Deskriptor, der einen Multicastsocket identifiziert.

[in] Interface

Die lokale IPv4-Adresse der Schnittstelle oder der Schnittstellenindex, in dem die Multicastgruppe verknüpft oder gelöscht werden soll.

Dieser Wert liegt in der Netzwerkbytereihenfolge vor. Wenn dieser Member die IPv4-Adresse 0.0.0.0 angibt, wird die IPv4-Standard-Multicastschnittstelle verwendet.

Jede IP-Adresse im 0.x.x.x-Block (erstes Oktett von 0) mit Ausnahme der IPv4-Adresse 0.0.0.0 wird als Schnittstellenindex behandelt. Ein Schnittstellenindex ist eine 24-Bit-Zahl, und der IPv4-Adressblock 0.0.0.0/8 wird nicht verwendet (dieser Bereich ist reserviert).

Die Verwendung eines Schnittstellenindexes von 1 entspricht der IP-Adresse 0.0.0.1.

[in] Group

Die IPv4-Adresse der Multicastgruppe.

[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 setipv4sourcefilter 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 Inlinefunktion setipv4sourcefilter wird verwendet, um den Multicastfilterstatus für einen IPv4-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