Funzione RtmGetExactMatchRoute (rtmv2.h)

Articolo
03/15/2023

La funzione RtmGetExactMatchRoute cerca la tabella di routing per una route che corrisponde esattamente alla route specificata. La route da cercare è indicata da un indirizzo di rete, una subnet mask e altri criteri di corrispondenza della route. Se viene trovata una corrispondenza esatta, vengono restituite le informazioni sulla route.

Sintassi

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
);

Parametri

[in] RtmRegHandle

Gestire il client ottenuto da una chiamata precedente a RtmRegisterEntity.

[in] DestAddress

Puntatore all'indirizzo di rete di destinazione.

[in] MatchingFlags

Specifica i criteri da usare durante la ricerca della route. Vengono usati i flag seguenti.

Costante	Significato
RTM_MATCH_FULL	Trovare le route corrispondenti a tutti i criteri.
RTM_MATCH_INTERFACE	Route di corrispondenza che si trovano nella stessa interfaccia.
RTM_MATCH_NEIGHBOUR	Match route con lo stesso vicino.
RTM_MATCH_NEXTHOP	Route di corrispondenza con lo stesso hop successivo.
RTM_MATCH_NONE	Non corrispondono a nessuno dei criteri; vengono restituite tutte le route per la destinazione.
RTM_MATCH_OWNER	Trovare le route di corrispondenza con lo stesso proprietario.
RTM_MATCH_PREF	Route di corrispondenza che hanno la stessa preferenza.

[in, out] RouteInfo

In input RouteInfo è un puntatore una struttura RTM_ROUTE_INFO che contiene i criteri che specifica la route da trovare.

In output RouteInfo riceve le informazioni sulla route per la route corrispondente ai criteri.

[in] InterfaceIndex

Se RTM_MATCH_INTERFACE è specificato in MatchingFlags, InterfaceIndex specifica l'interfaccia in cui deve essere presente la route, ovvero la route ha un hop successivo su tale interfaccia.

[in] TargetViews

Specifica le visualizzazioni da cui restituire informazioni. Se il client specifica RTM_VIEW_MASK_ANY, le informazioni di destinazione vengono restituite da tutte le visualizzazioni; tuttavia, non vengono restituite informazioni specifiche della visualizzazione.

[out] RouteHandle

Se deve essere restituito un handle: in input RouteHandle è un puntatore a NULL.

In output RouteHandle riceve un puntatore all'handle della route; in caso contrario, RouteHandle rimane invariato.

Se non è necessario restituire un handle: in input RouteHandle è NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_NOT_FOUND	La route specificata non è stata trovata.

Commenti

È consigliabile usare RtmGetExactMatchDestination se non sono presenti criteri di corrispondenza di route specificati nel parametro MatchingFlags .

I membri seguenti della struttura RTM_ROUTE_INFO passati nel parametro RouteInfo vengono usati per corrispondere a una route:

Vicino
NextHopsList
PrefInfo
RouteOwner

Requisiti


Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	rtmv2.h
Libreria	Rtm.lib
DLL	Rtm.dll