Funzione RtmGetLessSpecificDestination (rtmv2.h)
La funzione RtmGetLessSpecificDestination cerca la tabella di routing per una destinazione con il prefisso next-best-match (più lungo), dato un prefisso di destinazione. Vengono restituite le informazioni di destinazione richieste.
Sintassi
DWORD RtmGetLessSpecificDestination(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] RTM_DEST_HANDLE DestHandle,
[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] DestHandle
Gestire nella 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 quali informazioni di route 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 |
|---|---|
|
Un parametro contiene informazioni non corrette. |
|
Impossibile trovare la destinazione migliore successiva. |
Commenti
Il parametro DestInfo è una struttura di RTM_DEST_INFO di dimensioni variabili. Se il client specifica più visualizzazioni usando TargetViews, le dimensioni di DestInfo aumentano per ogni visualizzazione. Usare 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.
La funzione RtmGetLessSpecificDestination viene usata dopo una chiamata a RtmGetMostSpecificDestination per restituire la corrispondenza migliore per una destinazione. Questa chiamata viene usata anche dopo una chiamata precedente a RtmGetLessSpecificDestination per restituire la corrispondenza successiva meno specifica. I client possono usare questa funzione per "camminare" nell'albero del prefisso per una destinazione.
Questa chiamata viene usata anche dopo le chiamate alle funzioni che restituiscono una struttura RTM_DEST_INFO, ad esempio RtmGetDestInfo e RtmGetChangedDests.
La funzione RtmGetLessSpecificDestination restituisce corrispondenze finché non raggiunge la route predefinita, se esistente. Dopo aver trovato la route predefinita, RtmGetLessSpecificDestination restituisce ERROR_NOT_FOUND.
Un uso comune per le funzioni RtmGetLessSpecificDestination e RtmGetMostSpecificDestination , consiste nel recuperare ognuna delle destinazioni corrispondenti.
Per codice di esempio usando questa funzione, vedere Cercare route usando un albero di prefisso.
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 |