Freigeben über


setipv4sourcefilter-Funktion (ws2tcpip.h)

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

MULTICAST_MODE_TYPE

getipv4sourcefilter

getsourcefilter

in_addr

setsourcefilter