PGET_MFE_STATUS funzione di callback (routprot.h)

Articolo
03/01/2024

Il gestore router chiama la funzione GetMfeStatus per ottenere lo stato della voce di inoltro multicast (MFE) per l'interfaccia, l'indirizzo del gruppo e l'indirizzo di origine specificati.

Il tipo PGET_MFE_STATUS definisce un puntatore a questa funzione di callback. GetMfeStatus è un segnaposto per il nome della funzione definita dall'applicazione.

Sintassi

PGET_MFE_STATUS PgetMfeStatus;

DWORD PgetMfeStatus(
  [in]  DWORD InterfaceIndex,
  [in]  DWORD GroupAddress,
  [in]  DWORD SourceAddress,
  [out] PBYTE StatusCode
)
{...}

Parametri

[in] InterfaceIndex

Specifica l'indice dell'interfaccia per questa mfe.

[in] GroupAddress

Specifica l'indirizzo del gruppo multicast per questo MFE.

[in] SourceAddress

Specifica l'indirizzo di origine multicast per questo MFE.

[out] StatusCode

Puntatore a una variabile BYTE . Il protocollo di routing deve compilare questa variabile con uno dei valori seguenti. Il protocollo di routing deve selezionare il codice con valori più alti che si applica.

Valore	Significato
MFE_NO_ERROR	Nessuno dei valori seguenti si applica.
MFE_REACHED_CORE	Il computer locale in questo router è un router punto di incontro (RP)/core per il gruppo multicast.
MFE_OIF_PRUNED	Questo valore deve essere impostato solo dal proprietario dell'interfaccia in uscita. Il valore indica che nell'interfaccia in uscita non esistono ricevitori downstream.
MFE_PRUNED_UPSTREAM	Questo valore deve essere impostato solo dal proprietario dell'interfaccia in ingresso. Il valore indica che è stato inviato un messaggio di eliminazione a monte.
MFE_OLD_ROUTER	Questo valore deve essere impostato solo dal proprietario dell'interfaccia in ingresso. Il valore indica che il vicino upstream non supporta mtrace.

Valore restituito

Se la funzione ha esito positivo, il valore restituito deve essere NO_ERROR.

Se la funzione ha esito negativo, il valore restituito deve essere uno dei codici di errore seguenti.

Valore	Descrizione
ERROR_CAN_NOT_COMPLETE	Il protocollo di routing non è riuscito a completare la richiesta.
ERROR_INVALID_PARAMETER	Il parametro InterfaceIndex non è valido (ad esempio, nessuna interfaccia esiste con tale indice) oppure il gruppo o l'indirizzo di origine non è valido.

Commenti

Solo i protocolli di routing multicast devono implementare questa funzione. I protocolli di routing non multicast devono passare NULL come valore del puntatore per questa funzione in MPR_ROUTING_CHARACTERISTICS

Requisiti

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

Vedi anche

GetNeighbors

Condividi tramite