Fonction MgmReleaseInterfaceOwnership (mgm.h)
La fonction MgmReleaseInterfaceOwnership est utilisée par un client pour renoncer à la propriété d’une interface. Lorsque cette fonction est appelée, tous les MFM gérés par le gestionnaire de groupes de multidiffusion pour le compte du client et pour l’interface spécifiée sont supprimés.
Syntaxe
DWORD MgmReleaseInterfaceOwnership(
[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 à libérer.
[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 à laquelle tous les clients d’accès à distance se connectent.
Pour les interfaces de diffusion (telles que les interfaces Ethernet) ou 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 |
|---|---|
|
Impossible de terminer l’appel à cette fonction. |
|
Handle non valide pour un client, ou l’interface est introuvable. |
Remarques
Un client doit libérer la propriété de toutes les interfaces qu’il possède avant de se désinscrire avec la fonction MgmDeRegisterMProtocol .
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 |