Partager via


PGET_MFE_STATUS fonction de rappel (routprot.h)

Le gestionnaire de routeur appelle la fonction GetMfeStatus pour obtenir la status de l’entrée de transfert multidiffusion (MFE) pour l’interface, l’adresse de groupe et l’adresse source spécifiées.

Le type PGET_MFE_STATUS définit un pointeur vers cette fonction de rappel. GetMfeStatus est un espace réservé pour le nom de fonction défini par l’application.

Syntaxe

PGET_MFE_STATUS PgetMfeStatus;

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

Paramètres

[in] InterfaceIndex

Spécifie l’index de l’interface pour ce MFE.

[in] GroupAddress

Spécifie l’adresse de groupe de multidiffusion pour ce MFE.

[in] SourceAddress

Spécifie l’adresse source de multidiffusion pour ce MFE.

[out] StatusCode

Pointeur vers une variable BYTE . Le protocole de routage doit remplir cette variable avec l’une des valeurs suivantes. Le protocole de routage doit sélectionner le code à valeur la plus élevée qui s’applique.

Valeur Signification
MFE_NO_ERROR
Aucune des valeurs suivantes ne s’applique.
MFE_REACHED_CORE
L’ordinateur local sur ce routeur est un routeur de point de rendez-vous (RP)/core pour le groupe de multidiffusion.
MFE_OIF_PRUNED
Cette valeur doit être définie uniquement par le propriétaire de l’interface sortante. La valeur indique qu’il n’existe aucun récepteur en aval sur l’interface sortante.
MFE_PRUNED_UPSTREAM
Cette valeur doit être définie uniquement par le propriétaire de l’interface entrante. La valeur indique qu’un message prune a été envoyé amont.
MFE_OLD_ROUTER
Cette valeur doit être définie uniquement par le propriétaire de l’interface entrante. La valeur indique que le amont voisin ne prend pas en charge mtrace.

Valeur retournée

Si la fonction réussit, la valeur de retour doit être NO_ERROR.

Si la fonction échoue, la valeur de retour doit être l’un des codes d’erreur suivants.

Valeur Description
ERROR_CAN_NOT_COMPLETE
Le protocole de routage n’a pas pu terminer la demande.
ERROR_INVALID_PARAMETER
Le paramètre InterfaceIndex n’est pas valide (par exemple, il n’existe aucune interface avec cet index), ou le groupe ou l’adresse source n’est pas valide.
 
 

Remarques

Seuls les protocoles de routage de multidiffusion doivent implémenter cette fonction. Les protocoles de routage non multidiffusion doivent passer NULL comme valeur de pointeur pour cette fonction dans MPR_ROUTING_CHARACTERISTICS

Configuration requise

Condition requise Valeur
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête routprot.h

Voir aussi

GetNeighbors