Fonction MgmTakeInterfaceOwnership (mgm.h)

Article
03/06/2024

La fonction MgmTakeInterfaceOwnership est appelée par un client (par exemple, un protocole de routage) lorsqu’elle est activée sur une interface.

Un seul client peut prendre possession d’une interface donnée à tout moment. La seule exception à cette règle est l’IGMP. IGMP peut coexister avec un autre client sur une interface.

Syntaxe

DWORD MgmTakeInterfaceOwnership(
  [in] HANDLE hProtocol,
  [in] DWORD  dwIfIndex,
  [in] DWORD  dwIfNextHopAddr
);

Paramètres

[in] hProtocol

Gérez le protocole obtenu à partir d’un appel précédent à MgmRegisterMProtocol.

[in] dwIfIndex

Spécifie l’index de l’interface dont il faut prendre possession.

[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.

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_ALREADY_EXISTS	L’interface spécifiée appartient déjà à un autre protocole de routage.
ERROR_CAN_NOT_COMPLETE	Impossible de terminer l’appel à cette fonction.
ERROR_INVALID_PARAMETER	Handle non valide pour un client.
ERROR_NOT_ENOUGH_MEMORY	Mémoire insuffisante pour effectuer cette opération.

Remarques

Un client doit prendre possession d’une interface uniquement après s’être inscrit auprès du gestionnaire de groupe de multidiffusion, mais avant d’ajouter des entrées d’appartenance au groupe.

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

MgmGetProtocolOnInterface

MgmRegisterMProtocol

MgmReleaseInterfaceOwnership

Partager via