MgmGetProtocolOnInterface-Funktion (mgm.h)
Die MgmGetProtocolOnInterface-Funktion ruft die Protokoll-ID des Multicastroutingprotokolls ab, das die angegebene Schnittstelle besitzt.
Syntax
DWORD MgmGetProtocolOnInterface(
[in] DWORD dwIfIndex,
[in] DWORD dwIfNextHopAddr,
[in, out] PDWORD pdwIfProtocolId,
[in, out] PDWORD pdwIfComponentId
);
Parameter
[in] dwIfIndex
Gibt den Index der Schnittstelle an, für die die Protokoll-ID abgerufen werden 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.
[in, out] pdwIfProtocolId
Bei der Eingabe muss der Client einen Zeiger auf einen Speicherort im DWORD-Format bereitstellen.
Bei der Ausgabe empfängt pdwIfProtocolId die ID des Protokolls auf der durch dwIfIndex angegebenen Schnittstelle.
[in, out] pdwIfComponentId
Bei der Eingabe muss der Client einen Zeiger auf einen DWORD-Wert bereitstellen.
Bei der Ausgabe empfängt pdwIfComponentId die Komponenten-ID für die instance des Protokolls auf der Schnittstelle. Dieser Parameter wird mit pdwIfProtocolId verwendet, um eine instance eines Routingprotokolls eindeutig zu identifizieren.
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. |
|
Die angegebene Schnittstelle wurde vom Multicastgruppen-Manager nicht gefunden. |
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 |