RtmGetExactMatchRoute-Funktion (rtmv2.h)

Artikel
08/25/2023

Die RtmGetExactMatchRoute-Funktion durchsucht die Routingtabelle nach einer Route, die genau der angegebenen Route entspricht. Die zu suchde Route wird durch eine Netzwerkadresse, subnetzmaske und andere Routenabgleichskriterien angegeben. Wenn eine genaue Übereinstimmung gefunden wird, werden die Routeninformationen zurückgegeben.

Syntax

DWORD RtmGetExactMatchRoute(
  [in]      RTM_ENTITY_HANDLE RtmRegHandle,
  [in]      PRTM_NET_ADDRESS  DestAddress,
  [in]      RTM_MATCH_FLAGS   MatchingFlags,
  [in, out] PRTM_ROUTE_INFO   RouteInfo,
  [in]      ULONG             InterfaceIndex,
  [in]      RTM_VIEW_SET      TargetViews,
  [out]     PRTM_ROUTE_HANDLE RouteHandle
);

Parameter

[in] RtmRegHandle

Handle an den Client, der von einem vorherigen Aufruf von RtmRegisterEntity abgerufen wurde.

[in] DestAddress

Zeiger auf die Zielnetzwerkadresse.

[in] MatchingFlags

Gibt die Kriterien an, die bei der Suche nach der Route verwendet werden sollen. Die folgenden Flags werden verwendet.

Konstante	Bedeutung
RTM_MATCH_FULL	Passen Sie Routen mit allen Kriterien ab.
RTM_MATCH_INTERFACE	Übereinstimmung mit Routen, die sich auf derselben Schnittstelle befinden.
RTM_MATCH_NEIGHBOUR	Zuordnen von Routen mit demselben Nachbarn.
RTM_MATCH_NEXTHOP	Stimmen Sie Routen ab, die denselben nächsten Hop haben.
RTM_MATCH_NONE	Entspricht keinem der Kriterien. alle Routen für das Ziel werden zurückgegeben.
RTM_MATCH_OWNER	Zuordnen von Routen mit demselben Besitzer.
RTM_MATCH_PREF	Übereinstimmung mit Routen, die die gleiche Präferenz haben.

[in, out] RouteInfo

Bei der Eingabe ist RouteInfo ein Zeiger einer RTM_ROUTE_INFO Struktur, die die Kriterien enthält, die die zu findende Route angeben.

Bei der Ausgabe empfängt RouteInfo die Routeninformationen für die Route, die den Kriterien entspricht.

[in] InterfaceIndex

Wenn RTM_MATCH_INTERFACE in MatchingFlags angegeben ist, gibt InterfaceIndex die Schnittstelle an, auf der die Route vorhanden sein muss (d. h. die Route verfügt über einen nächsten Hop auf dieser Schnittstelle).

[in] TargetViews

Gibt die Ansichten an, aus denen Informationen zurückgegeben werden sollen. Wenn der Client RTM_VIEW_MASK_ANY angibt, werden Zielinformationen aus allen Ansichten zurückgegeben. es werden jedoch keine ansichtsspezifischen Informationen zurückgegeben.

[out] RouteHandle

Wenn ein Handle zurückgegeben werden muss: Bei der Eingabe ist RouteHandle ein Zeiger auf NULL.

Bei der Ausgabe empfängt RouteHandle einen Zeiger auf das Routenhandle. Andernfalls bleibt RouteHandle unverändert.

Wenn kein Handle zurückgegeben werden muss: Bei der Eingabe ist RouteHandleNULL.

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_NOT_FOUND	Die angegebene Route wurde nicht gefunden.

Hinweise

Erwägen Sie die Verwendung von RtmGetExactMatchDestination , wenn Im MatchingFlags-Parameter keine Routenübereinstimmungskriterien angegeben sind.

Die folgenden Member der RTM_ROUTE_INFO-Struktur , die im RouteInfo-Parameter übergeben wird, werden verwendet, um eine Route abzugleichen:

Nachbar
NextHopsList
PrefInfo
RouteOwner

Anforderungen


Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	rtmv2.h
Bibliothek	Rtm.lib
DLL	Rtm.dll