Funzione RtmGetMostSpecificDestination (rtmv2.h)

Articolo
03/01/2024

La funzione RtmGetMostSpecificDestination cerca nella tabella di routing una destinazione con la corrispondenza esatta per un indirizzo di rete e una subnet mask specificati; se la corrispondenza esatta non viene trovata, viene trovata la corrispondenza con il prefisso migliore. Vengono restituite le informazioni di destinazione.

Sintassi

DWORD RtmGetMostSpecificDestination(
  [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

Handle per 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 le informazioni sulla route da restituire. Ad esempio, se un client specifica l'identificatore del protocollo RIP, viene restituita la route 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; non vengono tuttavia restituite informazioni specifiche della visualizzazione.

[out] DestInfo

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

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

Valore restituito

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

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

Valore	Significato
ERROR_INVALID_HANDLE	Handle non valido.
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, la dimensione di DestInfo aumenta per ogni visualizzazione. Utilizzare la macro RTM_SIZE_OF_DEST_INFO per determinare la quantità di memoria da allocare per la struttura DestInfo prima di chiamare questa funzione. Usare il valore specificato per TargetViews come parametro per RTM_SIZE_OF_DEST_INFO.

Per il codice di esempio che usa questa funzione, vedere Cercare route usando un albero dei prefissi.

Requisiti

Requisito	Valore
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