Funzione MgmDeleteGroupMembershipEntry (mgm.h)
La funzione MgmDeleteGroupMembershipEntry notifica al gestore del gruppo multicast che non sono presenti più ricevitori per i gruppi specificati nell'interfaccia specificata.
Un protocollo di routing multicast chiama questa funzione dopo la notifica che non sono presenti più ricevitori per un gruppo multicast in un'interfaccia. Il protocollo deve chiamare questa funzione per impedire l'inoltro dei dati multicast su un'interfaccia.
Sintassi
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
);
Parametri
[in] hProtocol
Gestire il protocollo ottenuto da una chiamata precedente a MgmRegisterMProtocol.
[in] dwSourceAddr
Specifica l'indirizzo di origine da cui interrompere la ricezione di dati multicast. Specificare zero per interrompere la ricezione di dati da tutte le origini (un ricevitore con caratteri jolly per un gruppo); in caso contrario, specificare l'indirizzo IP della rete di origine o di origine.
Per specificare un intervallo di indirizzi di origine, specificare la rete di origine usando dwSourceAddr e specificare una subnet mask usando 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.
Specificare zero per questo parametro se è stato specificato zero per dwSourceAddr (un ricevitore con caratteri jolly).
[in] dwGroupAddr
Specifica il gruppo multicast per cui interrompere la ricezione dei dati. Specificare zero per interrompere la ricezione di tutti i gruppi (un ricevitore con caratteri jolly); in caso contrario, specificare l'indirizzo IP del gruppo.
Per specificare un intervallo di indirizzi di gruppo, specificare l'indirizzo del gruppo usando dwGroupAddr e specificare una subnet mask usando 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.
Specificare zero per questo parametro se è stato specificato zero per dwGroupAddr (ricevitore con caratteri jolly).
[in] dwIfIndex
Specifica l'interfaccia in cui eliminare l'appartenenza al gruppo. I dati multicast per i gruppi specificati non vengono più inoltrati tramite questa interfaccia.
[in] dwIfNextHopIPAddr
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.
[in] dwFlags
Specifica qualsiasi elaborazione aggiuntiva che deve essere eseguita quando viene rimossa l'appartenenza al gruppo. I valori validi sono:
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.
Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.
Valore | Significato |
---|---|
|
Impossibile completare la chiamata a questa funzione. |
|
Handle non valido per un protocollo o l'interfaccia è di proprietà di un altro protocollo. |
|
L'interfaccia specificata non è stata trovata. |
Commenti
Questa versione dell'API MGM supporta solo origini con caratteri jolly o origini specifiche, non un'ampia gamma di origini. La stessa restrizione si applica ai gruppi ( ovvero non sono consentiti intervalli di gruppi).
Quando questa funzione viene chiamata, gestione gruppi multicast può richiamare il callback PMGM_PRUNE_ALERT_CALLBACK per notificare ad altri protocolli di routing che non sono presenti più ricevitori per il gruppo specificato.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Nessuno supportato |
Server minimo supportato | Windows 2000 Server [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | mgm.h |
Libreria | Rtm.lib |
DLL | Rtm.dll |