Funzione RtmGetExactMatchDestination (rtmv2.h)

Articolo
08/25/2023

La funzione RtmGetExactMatchDestination cerca la tabella di routing per una destinazione che corrisponde esattamente all'indirizzo di rete e alla subnet mask specificati. Se viene trovata una corrispondenza esatta, vengono restituite le informazioni per tale destinazione.

Sintassi

DWORD RtmGetExactMatchDestination(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  PRTM_NET_ADDRESS  DestAddress,
  [in]  ULONG             ProtocolId,
  [in]  RTM_VIEW_SET      TargetViews,
  [out] PRTM_DEST_INFO    DestInfo
);

Parametri

[in] RtmRegHandle

Gestire il client ottenuto da una chiamata precedente a RtmRegisterEntity.

[in] DestAddress

Puntatore all'indirizzo di rete di destinazione.

[in] ProtocolId

Specifica l'identificatore del protocollo. ProtocolID non fa parte dei criteri di ricerca. Gestione tabelle di routing usa questo identificatore per determinare quale destinazione e instradare le informazioni da restituire. Ad esempio, se un client specifica l'identificatore del protocollo RIP, viene restituita la route di rip migliore, anche se una route non RIP è la route migliore per la destinazione.

Specificare RTM_BEST_PROTOCOL per restituire una route indipendentemente dal protocollo proprietario. Specificare RTM_THIS_PROTOCOL per restituire la route migliore per il protocollo chiamante.

[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] DestInfo

In input, DestInfo è un puntatore a una struttura RTM_DEST_INFO .

Nell'output, DestInfo viene riempito con le informazioni di destinazione richieste.

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 destinazione specificata non è stata trovata.

Commenti

La struttura DestInfo è una struttura di dimensioni variabili. Se il client specifica più visualizzazioni con TargetViews, le dimensioni di DestInfo aumentano per ogni visualizzazione. Usare la macro RTM_SIZE_OF_DEST_INFO per determinare la quantità di una struttura DestInfo da allocare prima di chiamare questa funzione. Usare il valore specificato per TargetViews come parametro per RTM_SIZE_OF_DEST_INFO.

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