Fonction MgmGetProtocolOnInterface (mgm.h)

Article
02/29/2024

La fonction MgmGetProtocolOnInterface récupère l’ID de protocole du protocole de routage multidiffusion qui possède l’interface spécifiée.

Syntaxe

DWORD MgmGetProtocolOnInterface(
  [in]      DWORD  dwIfIndex,
  [in]      DWORD  dwIfNextHopAddr,
  [in, out] PDWORD pdwIfProtocolId,
  [in, out] PDWORD pdwIfComponentId
);

Paramètres

[in] dwIfIndex

Spécifie l’index de l’interface pour laquelle récupérer l’ID de protocole.

[in] dwIfNextHopAddr

Spécifie l’adresse du tronçon suivant qui correspond à l’index spécifié par dwIfIndex. Les paramètres dwIfIndex et dwIfNextHopIPAddr identifient de manière unique un tronçon suivant sur les interfaces point à multipoint. Une interface de point à multipoint est une connexion par laquelle une interface se connecte à plusieurs réseaux. Parmi les exemples d’interfaces point à multipoint, citons les interfaces NBMA (Non Broadcast Multiple Access) et l’interface interne sur laquelle tous les clients d’accès à distance se connectent.

Pour les interfaces de diffusion (telles que les interfaces Ethernet) ou les interfaces point à point, qui sont identifiées uniquement par la valeur de dwIfIndex, spécifiez zéro.

[in, out] pdwIfProtocolId

Lors de l’entrée, le client doit fournir un pointeur vers un emplacement mémoire de taille DWORD.

À la sortie, pdwIfProtocolId reçoit l’ID du protocole sur l’interface spécifiée par dwIfIndex.

[in, out] pdwIfComponentId

Lors de l’entrée, le client doit fournir un pointeur vers une valeur DWORD .

À la sortie, pdwIfComponentId reçoit l’ID de composant pour le instance du protocole sur l’interface. Ce paramètre est utilisé avec pdwIfProtocolId pour identifier de manière unique un instance d’un protocole de routage.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

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

Valeur	Signification
ERROR_CAN_NOT_COMPLETE	Impossible de terminer l’appel à cette fonction.
ERROR_NOT_FOUND	L’interface spécifiée n’a pas été trouvée par le gestionnaire de groupe de multidiffusion.

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	mgm.h
Bibliothèque	Rtm.lib
DLL	Rtm.dll

Voir aussi

MgmReleaseInterfaceOwnership

MgmTakeInterfaceOwnership

Partager via