PGET_NEIGHBORS Rückruffunktion (routprot.h)

Artikel
03/06/2024

Der Router-Manager ruft die GetNeighbors-Funktion auf, um die Abfrage für das Netzwerk abzurufen, das über die angegebene Schnittstelle angefügt ist.

Der PGET_NEIGHBORS Typ definiert einen Zeiger auf diese Rückruffunktion. GetNeighbors ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

PGET_NEIGHBORS PgetNeighbors;

DWORD PgetNeighbors(
  [in]      DWORD InterfaceIndex,
  [in]      PDWORD NeighborList,
  [in, out] PDWORD NeighborListSize,
  [out]     PBYTE InterfaceFlags
)
{...}

Parameter

[in] InterfaceIndex

Gibt den Index der Schnittstelle an, für die das Routingprotokoll die Abfrage bereitstellen soll.

[in] NeighborList

Zeiger auf eine Array-DWORD-Variablen . Das Routingprotokoll sollte dieses Array mit der Adresse des Abfragens füllen.

Wenn der lokale Computer der Querierer für das Netzwerk ist, das über die angegebene Schnittstelle angefügt ist, muss das Routingprotokoll diese Variable nicht ausfüllen. Stattdessen sollte das Routingprotokoll den Wert, auf den neighborListSize verweist, auf Null festlegen. Außerdem sollte das Routingprotokoll den im Parameter InterfaceFlags zurückgegebenen Flags MRINFO_QUERIER_FLAG hinzufügen.

[in, out] NeighborListSize

Zeigen Sie bei der Eingabe auf eine DWORD-Variable .

Bei der Ausgabe füllt das Routingprotokoll diese Variable mit der Länge (in Byte) der adresse aus, die im NeighborList-Parameter zurückgegeben wird.

[out] InterfaceFlags

Empfängt eines oder mehrere der folgenden Flags. Die Flags beschreiben die Beziehung des lokalen Computers zu anderen Computern im Netzwerk, die über die angegebene Schnittstelle verbunden sind.

MRINFO_TUNNEL_FLAGMRINFO_PIM_FLAGMRINFO_DOWN_FLAGMRINFO_DISABLED_FLAGMRINFO_QUERIER_FLAG MRINFO_LEAF_FLAG

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	BESCHREIBUNG
ERROR_CAN_NOT_COMPLETE	Das Routingprotokoll konnte die Anforderung nicht abschließen.
ERROR_INSUFFICIENT_BUFFER	Die Größe des Puffers, auf den NeighborList verweist, ist nicht groß genug, um die Adresse zu speichern. Die erforderliche Größe wird in der DWORD-Variablen zurückgegeben, auf die der Parameter NeighborListSize verweist.
ERROR_INVALID_PARAMETER	Der Parameter InterfaceIndex ist ungültig (z. B. ist mit diesem Index keine Schnittstelle vorhanden).

Hinweise

Nur Multicastroutingprotokolle sind erforderlich, um diese Funktion zu implementieren. Nicht-Multicastroutingprotokolle sollten NULL als Zeigerwert für diese Funktion in MPR_ROUTING_CHARACTERISTICS

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	routprot.h

Weitere Informationen

GetMfeStatus

Freigeben über