Share via

PMGM_LOCAL_LEAVE_CALLBACK funzione di callback (mgm.h)

  • Articolo

Il callback PMGM_LOCAL_LEAVE_CALLBACK è una chiamata a un protocollo di routing per notificare al protocollo di routing che IGMP ha rilevato che non dispone più di ricevitori per un gruppo in un'interfaccia attualmente di proprietà del protocollo di routing.

Questo callback viene richiamato quando la funzione MgmDeleteGroupMembershipEntry viene chiamata da IGMP.

Sintassi

PMGM_LOCAL_LEAVE_CALLBACK PmgmLocalLeaveCallback;

DWORD PmgmLocalLeaveCallback(
  [in] DWORD dwSourceAddr,
  [in] DWORD dwSourceMask,
  [in] DWORD dwGroupAddr,
  [in] DWORD dwGroupMask,
  [in] DWORD dwIfIndex,
  [in] DWORD dwIfNextHopAddr
)
{...}

Parametri

[in] dwSourceAddr

Specifica l'indirizzo di origine da cui interrompere la ricezione di dati multicast. Zero indica di interrompere la ricezione di dati da tutte le origini (un ricevitore con caratteri jolly per un gruppo); in caso contrario, il valore di dwSourceAddr è l'indirizzo IP della rete di origine o di origine.

Per specificare un intervallo di indirizzi di origine, gestione gruppi multicast specifica la rete di origine tramite dwSourceAddr e specifica una subnet mask tramite dwSourceMask.

[in] dwSourceMask

Specifica la subnet mask che corrisponde a dwSourceAddr. I parametri dwSourceAddr e dwSourceMask vengono usati insieme per definire un intervallo di origini da cui interrompere la ricezione di dati multicast.

Il gestore gruppi multicast specifica zero per questo parametro se è stato specificato anche zero per dwSourceAddr (un ricevitore con caratteri jolly).

[in] dwGroupAddr

Specifica il gruppo multicast per cui interrompere la ricezione dei dati. Zero indica di interrompere la ricezione dei dati per tutti i gruppi (un ricevitore con caratteri jolly); in caso contrario, il valore di dwGroupAddr è l'indirizzo IP del gruppo.

Per specificare un intervallo di indirizzi di gruppo, gestione gruppi multicast specifica l'indirizzo del gruppo tramite dwGroupAddr e specifica una subnet mask tramite dwGroupMask.

[in] dwGroupMask

Specifica la subnet mask che corrisponde a dwGroupAddr. I parametri dwGroupAddr e dwGroupMask vengono usati insieme per definire un intervallo di gruppi multicast.

Gestione gruppi multicast specifica zero per questo parametro se è stato specificato anche zero per dwGroupAddr (ricevitore con caratteri jolly).

[in] dwIfIndex

Specifica l'interfaccia in cui interrompere la ricezione di dati multicast.

[in] dwIfNextHopAddr

Specifica l'indirizzo dell'hop successivo che corrisponde all'indice specificato da dwIfIndex. I parametri dwIfIndex e dwIfNextHopIPAddr identificano in modo univoco un hop successivo sulle interfacce da punto a più punti. Un'interfaccia da punto a punto è una connessione in cui un'interfaccia si connette a più reti. Esempi di interfacce da punto a più punti includono interfacce di accesso multiplo (NBMA) non broadcast e l'interfaccia interna in cui si connettono tutti i client di connessione remota.

Per le interfacce di trasmissione (ad esempio interfacce Ethernet) o interfacce da punto a punto, identificate solo dal valore di dwIfIndex, specificano zero.

Valore restituito

RRAS non prevede che l'applicazione restituisca alcun valore specifico; qualsiasi valore restituito viene ignorato da RRAS.

Commenti

Questa versione dell'API Gestione gruppi multicast supporta solo origini con caratteri jolly (*, g) o origini specifiche (s, g), non un intervallo di origini. La stessa restrizione si applica ai gruppi ( ovvero non sono consentiti intervalli di gruppi).

Requisiti

Requisito Valore
Client minimo supportato Nessuno supportato
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione mgm.h

Vedi anche

PMGM_LOCAL_JOIN_CALLBACK