MgmDeleteGroupMembershipEntry-Funktion (mgm.h)

Artikel
08/24/2023

Die Funktion MgmDeleteGroupMembershipEntry benachrichtigt den Multicastgruppen-Manager, dass für die angegebenen Gruppen auf der angegebenen Schnittstelle keine Empfänger mehr vorhanden sind.

Ein Multicastroutingprotokoll ruft diese Funktion auf, nachdem benachrichtigt wurde, dass keine Empfänger mehr für eine Multicastgruppe auf einer Schnittstelle vorhanden sind. Das Protokoll muss diese Funktion aufrufen, um zu verhindern, dass Multicastdaten über eine Schnittstelle weitergeleitet werden.

Syntax

DWORD MgmDeleteGroupMembershipEntry(
  [in] HANDLE hProtocol,
  [in] DWORD  dwSourceAddr,
  [in] DWORD  dwSourceMask,
  [in] DWORD  dwGroupAddr,
  [in] DWORD  dwGroupMask,
  [in] DWORD  dwIfIndex,
  [in] DWORD  dwIfNextHopIPAddr,
  [in] DWORD  dwFlags
);

Parameter

[in] hProtocol

Handle mit dem Protokoll, das aus einem vorherigen Aufruf von MgmRegisterMProtocol abgerufen wurde.

[in] dwSourceAddr

Gibt die Quelladresse an, von der der Empfang von Multicastdaten beendet werden soll. Geben Sie null an, um den Empfang von Daten aus allen Quellen zu beenden (ein Wildcardempfänger für eine Gruppe); Geben Sie andernfalls die IP-Adresse des Quell- oder Quellnetzwerks an.

Um einen Bereich von Quelladressen anzugeben, geben Sie das Quellnetzwerk mithilfe von dwSourceAddr an, und geben Sie mithilfe von dwSourceMask eine Subnetzmaske an.

[in] dwSourceMask

Gibt die Subnetzmaske an, die dwSourceAddr entspricht. Die Parameter dwSourceAddr und dwSourceMask werden zusammen verwendet, um einen Bereich von Quellen zu definieren, aus denen der Empfang von Multicastdaten beendet werden soll.

Geben Sie null für diesen Parameter an, wenn für dwSourceAddr (ein Wildcardempfänger) null angegeben wurde.

[in] dwGroupAddr

Gibt die Multicastgruppe an, für die der Empfang von Daten beendet werden soll. Geben Sie null an, um den Empfang aller Gruppen (einen Wildcardempfänger) zu beenden. Geben Sie andernfalls die IP-Adresse der Gruppe an.

Um einen Bereich von Gruppenadressen anzugeben, geben Sie die Gruppenadresse mithilfe von dwGroupAddr an, und geben Sie mithilfe von dwGroupMask eine Subnetzmaske an.

[in] dwGroupMask

Gibt die Subnetzmaske an, die dwGroupAddr entspricht. Die Parameter dwGroupAddr und dwGroupMask werden zusammen verwendet, um einen Bereich von Multicastgruppen zu definieren.

Geben Sie null für diesen Parameter an, wenn null für dwGroupAddr (ein Wildcardempfänger) angegeben wurde.

[in] dwIfIndex

Gibt die Schnittstelle an, auf der die Gruppenmitgliedschaft gelöscht werden soll. Multicastdaten für die angegebenen Gruppen werden nicht mehr über diese Schnittstelle weitergeleitet.

[in] dwIfNextHopIPAddr

Gibt die Adresse des nächsten Hops an, die dem von dwIfIndex angegebenen Index entspricht. Die Parameter dwIfIndex und dwIfNextHopIPAddr identifizieren einen nächsten Hop auf Point-to-Multipoint-Schnittstellen eindeutig. Eine Point-to-Multipoint-Schnittstelle ist eine Verbindung, bei der eine Schnittstelle eine Verbindung mit mehreren Netzwerken herstellt. Beispiele für Point-to-Multipoint-Schnittstellen sind NBMA-Schnittstellen (Non-Broadcast Multiple Access) und die interne Schnittstelle, über die alle DFÜ-Clients eine Verbindung herstellen.

Geben Sie für Broadcastschnittstellen (z. B. Ethernet-Schnittstellen) oder Punkt-zu-Punkt-Schnittstellen, die nur durch den Wert von dwIfIndex identifiziert werden, null an.

[in] dwFlags

Gibt alle zusätzlichen Verarbeitungen an, die beim Entfernen der Gruppenmitgliedschaft erfolgen müssen. Gültige Werte sind:

Wert	Bedeutung
MGM_JOIN_STATE_FLAG	Entfernen Sie die Gruppenmitgliedschaft für die angegebene Quelle und Gruppe. Aktualisieren Sie alle Weiterleitungseinträge für die angegebene Quellgruppe, um diese Änderung in der Gruppenmitgliedschaft widerzuspiegeln.
MGM_FORWARD_STATE	Entfernen Sie die angegebene Schnittstelle aus der Liste der ausgehenden Schnittstellen für den Weiterleitungseintrag, der der angegebenen Quelle und Gruppe entspricht.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Wert	Bedeutung
ERROR_CAN_NOT_COMPLETE	Der Aufruf dieser Funktion konnte nicht abgeschlossen werden.
ERROR_INVALID_PARAMETER	Ungültiges Handle für ein Protokoll, oder die Schnittstelle gehört einem anderen Protokoll.
ERROR_NOT_FOUND	Die angegebene Schnittstelle wurde nicht gefunden.

Hinweise

Diese Version der MGM-API unterstützt nur Wildcardquellen oder bestimmte Quellen, nicht einen Bereich von Quellen. Die gleiche Einschränkung gilt für Gruppen (d. a. keine Gruppenbereiche sind zulässig).

Wenn diese Funktion aufgerufen wird, kann der Multicastgruppen-Manager den PMGM_PRUNE_ALERT_CALLBACK Rückruf aufrufen, um andere Routingprotokolle zu benachrichtigen, dass für die angegebene Gruppe keine Empfänger mehr vorhanden sind.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mgm.h
Bibliothek	Rtm.lib
DLL	Rtm.dll

Weitere Informationen

MgmAddGroupMembershipEntry

PMGM_PRUNE_ALERT_CALLBACK

Freigeben über