MgmTakeInterfaceOwnership-Funktion (mgm.h)

Artikel
08/24/2023

Die MgmTakeInterfaceOwnership-Funktion wird von einem Client (z. B. einem Routingprotokoll) aufgerufen, wenn sie auf einer Schnittstelle aktiviert ist.

Nur ein Client kann jederzeit den Besitz einer bestimmten Schnittstelle übernehmen. Die einzige Ausnahme von dieser Regel ist die IGMP. IGMP kann zusammen mit einem anderen Client auf einer Schnittstelle vorhanden sein.

Syntax

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

Parameter

[in] hProtocol

Handle mit dem Protokoll, das aus einem vorherigen Aufruf von MgmRegisterMProtocol abgerufen wurde.

[in] dwIfIndex

Gibt den Index der Schnittstelle an, deren Besitzer sie übernehmen soll.

[in] dwIfNextHopAddr

Gibt die Adresse des nächsten Hops an, die dem von dwIfIndex angegebenen Index entspricht. Die Parameter dwIfIndex und dwIfNextHopIPAddr identifizieren einen nächsten Hop auf Point-to-Multipoint-Schnittstellen eindeutig. 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
ERROR_ALREADY_EXISTS	Die angegebene Schnittstelle ist bereits im Besitz eines anderen Routingprotokolls.
ERROR_CAN_NOT_COMPLETE	Der Aufruf dieser Funktion konnte nicht abgeschlossen werden.
ERROR_INVALID_PARAMETER	Ungültiges Handle für einen Client.
ERROR_NOT_ENOUGH_MEMORY	Nicht genügend Arbeitsspeicher, um diesen Vorgang abzuschließen.

Hinweise

Ein Client muss den Besitz einer Schnittstelle erst übernehmen, nachdem er sich beim Multicastgruppen-Manager registriert hat, aber bevor er Gruppenmitgliedschaftseinträge hinzufügt.

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

Weitere Informationen

MgmGetProtocolOnInterface

MgmRegisterMProtocol

MgmReleaseInterfaceOwnership

Freigeben über