PMGM_PRUNE_ALERT_CALLBACK Rückruffunktion (mgm.h)

Der PMGM_PRUNE_ALERT_CALLBACK Rückrufs ist ein Aufruf in ein Routingprotokoll, um das Protokoll zu benachrichtigen, dass empfänger nicht mehr auf Schnittstellen vorhanden sind, die anderen Routingprotokollen gehören.

Syntax

PMGM_PRUNE_ALERT_CALLBACK PmgmPruneAlertCallback;

DWORD PmgmPruneAlertCallback(
  [in]      DWORD dwSourceAddr,
  [in]      DWORD dwSourceMask,
  [in]      DWORD dwGroupAddr,
  [in]      DWORD dwGroupMask,
  [in]      DWORD dwIfIndex,
  [in]      DWORD dwIfNextHopAddr,
  [in]      BOOL bMemberDelete,
  [in, out] PDWORD pdwTimeout
)
{...}

Parameter

[in] dwSourceAddr

Gibt die Quelladresse an, von der der Empfang von Multicastdaten beendet werden soll. Null gibt an, dass der Empfang von Daten aus allen Quellen beendet wird (ein Wildcardempfänger für eine Gruppe). Andernfalls ist der Wert von dwSourceAddr die IP-Adresse des Quell- oder Quellnetzwerks.

Um einen Bereich von Quelladressen anzugeben, gibt der Multicastgruppen-Manager das Quellnetzwerk mithilfe von dwSourceAddr an und gibt eine Subnetzmaske mit dwSourceMask 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, von denen der Empfang von Multicastdaten beendet werden soll.

Der Multicastgruppen-Manager gibt null für diesen Parameter an, wenn er auch null für dwSourceAddr (einen Feldhalterempfänger) angegeben hat.

[in] dwGroupAddr

Gibt die Multicastgruppe an, für die der Empfang von Daten beendet werden soll. Null gibt an, dass der Empfang von Daten für alle Gruppen (ein Wildcardempfänger) beendet wird. andernfalls ist der Wert von dwGroupAddr die IP-Adresse der Gruppe.

Um einen Bereich von Gruppenadressen anzugeben, gibt der Multicastgruppen-Manager die Gruppenadresse mithilfe von dwGroupAddr an und gibt eine Subnetzmaske mit dwGroupMask 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.

Der Multicastgruppen-Manager gibt null für diesen Parameter an, wenn er auch null für dwGroupAddr (einen Feldhalterempfänger) angegeben hat.

[in] dwIfIndex

Gibt die Schnittstelle an, über die der Empfang von Multicastdaten beendet werden soll.

[in] dwIfNextHopAddr

Gibt die Adresse des nächsten Hops an, die dem von dwIfIndex angegebenen Index entspricht. Die Parameter dwIfIndex und dwIfNextHopIPAddr identifizieren eindeutig einen nächsten Hop auf Point-to-Multipoint-Schnittstellen. 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] bMemberDelete

Gibt an, ob der Rückruf aufgerufen wurde, weil mgmAddGroupMembershipEntry von einem Client aufgerufen wurde (der Multicastgruppen-Manager legt diesen Parameter auf TRUE fest), oder weil ein MFE erstellt oder aktualisiert wurde (der Multicastgruppen-Manager legt diesen Parameter auf FALSE fest).

[in, out] pdwTimeout

Bei der Eingabe zeigt pdwTimeout auf einen Speicherspeicherort im DWORD-Format.

Wenn bMemberDeleteFALSE ist, kann mit diesem Parameter angegeben werden, wie lange die entsprechende MFE im Multicastweiterleitungscache verbleiben soll. Wenn der Client keinen Wert angibt, beträgt der Standardwert 900 Sekunden.

Bei der Ausgabe empfängt pdwTimeout den Timeoutwert in Sekunden für diese MFE.

Rückgabewert

RRAS erwartet nicht, dass die Anwendung einen bestimmten Wert zurückgibt. alle zurückgegebenen Werte werden von RRAS ignoriert.

Hinweise

Der Multicastgruppen-Manager legt den bMemberDelete-Parameter auf TRUE fest und ruft diesen Rückruf auf, wenn ein Client die MgmDeleteGroupMembershipEntry-Funktion für einen (s, g), (, g) oder (, *) Eintrag aufruft (d. a. die Gruppenmitgliedschaft ändert sich).

Der Multicastgruppen-Manager legt den bMemberDelete-Parameter auf FALSE fest, wenn sich die Liste der ausgehenden Schnittstellen für eine MFE ändert. Diese Änderung tritt in der Regel bei einer Änderung der Mitgliedschaft für die Gruppe auf, die der MFE entspricht.

Ein Multicastroutingprotokoll kann den bMemberDelete-Parameter verwenden, um zwischen Änderungen an der Gruppenmitgliedschaft und Änderungen an der MFE zu unterscheiden.

Die Vom Routingprotokoll ausgeführte Aktion, wenn dieser Rückruf empfangen wird, ist protokollspezifisch. Das Protokoll ignoriert möglicherweise den Rückruf, wenn der bMemberDelete-Parameter auf FALSE festgelegt ist, wenn die Protokollspezifikation angibt, dass dies das richtige Verhalten ist.

Wenn MgmDeleteGroupMembershipEntry aufgerufen wird, verwendet der Multicastgruppen-Manager diesen Rückruf, um andere Multicastgruppen-Manager-Clients zu benachrichtigen, dass es keine Empfänger mehr für die angegebene Quelle und Gruppe gibt.

Der Multicastgruppen-Manager verwendet die folgenden Regeln, um zu bestimmen, wann dieser Rückruf für Wildcard-Joins (*, g) aufgerufen werden soll:

• Wenn die endgültige Schnittstelle für den vorletzten Client entfernt wird (d. h., wenn Schnittstellen für nur einen einzelnen Client verbleiben), ruft der Multicastgruppen-Manager den PMGM_PRUNE_ALERT_CALLBACK Rückruf für diesen verbleibenden Client auf.
• Wenn die endgültige Schnittstelle für den letzten Client entfernt wird (d. h. wenn keine anderen Schnittstellen mehr vorhanden sind), wird dieser Rückruf für alle anderen Clients aufgerufen, die beim Multicastgruppen-Manager registriert sind.

• Wenn eine quellspezifische Prune für eine Gruppe (s, g) empfangen wird, ruft der Multicastgruppen-Manager den PMGM_PRUNE_ALERT_CALLBACK Rückruf nur für den Client auf, der die eingehende Schnittstelle zu den Quell-"s" besitzt.

Anforderungen

Weitere Informationen

PMGM_CREATION_ALERT_CALLBACK