MgmReleaseInterfaceOwnership-Funktion (mgm.h)
Die MgmReleaseInterfaceOwnership-Funktion wird von einem Client verwendet, um den Besitz an einer Schnittstelle aufzugeben. Wenn diese Funktion aufgerufen wird, werden alle MFEs gelöscht, die vom Multicastgruppen-Manager im Auftrag des Clients und für die angegebene Schnittstelle verwaltet werden.
Syntax
DWORD MgmReleaseInterfaceOwnership(
[in] HANDLE hProtocol,
[in] DWORD dwIfIndex,
[in] DWORD dwIfNextHopAddr
);
Parameter
[in] hProtocol
Handle mit dem Protokoll, das von einem vorherigen Aufruf von MgmRegisterMProtocol abgerufen wurde.
[in] dwIfIndex
Gibt den Index der zu veröffentlichenden Schnittstelle an.
[in] dwIfNextHopAddr
Gibt die Adresse des nächsten Hops an, die dem von dwIfIndex angegebenen Index entspricht. Die Parameter dwIfIndex und dwIfNextHopIPAddr identifizieren eindeutig einen nächsten Hop auf Point-to-Multipoint-Schnittstellen. Eine Point-to-Multipoint-Schnittstelle ist eine Verbindung, bei der eine Schnittstelle eine Verbindung mit mehreren Netzwerken herstellt. Beispiele für Point-to-Multipoint-Schnittstellen sind NBMA-Schnittstellen (Non-Broadcast Multiple Access) und die interne Schnittstelle, über die alle DFÜ-Clients eine Verbindung herstellen.
Geben Sie für Broadcastschnittstellen (z. B. Ethernet-Schnittstellen) oder Punkt-zu-Punkt-Schnittstellen, die nur durch den Wert von dwIfIndex identifiziert werden, null an.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.
Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes:
| Wert | Bedeutung |
|---|---|
|
Der Aufruf dieser Funktion konnte nicht abgeschlossen werden. |
|
Ungültiges Handle für einen Client, oder die Schnittstelle wurde nicht gefunden. |
Hinweise
Ein Client muss den Besitz aller Schnittstellen freigeben, die er besitzt, bevor er sich mit der MgmDeRegisterMProtocol-Funktion auflöst.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mgm.h |
| Bibliothek | Rtm.lib |
| DLL | Rtm.dll |