PGET_MFE_STATUS fonction de rappel (routprot.h)

Article
03/06/2024

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

Partager via