Funzione RtmGetListEnumRoutes (rtmv2.h)
La funzione RtmGetListEnumRoutes enumera un set di route in un elenco di route specificato.
Sintassi
DWORD RtmGetListEnumRoutes(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] RTM_ENUM_HANDLE EnumHandle,
[in, out] PUINT NumRoutes,
[out] PRTM_ROUTE_HANDLE RouteHandles
);
Parametri
[in] RtmRegHandle
Gestire il client ottenuto da una chiamata precedente a RtmRegisterEntity.
[in] EnumHandle
Gestire l'elenco di route da enumerare.
[in, out] NumRoutes
In input NumRoutes è un puntatore a un valore UINT che specifica il numero massimo di route che possono essere ricevute da RouteHandles.
Nell'output NumRoutes riceve il numero effettivo di route ricevute da RouteHandles.
[out] RouteHandles
In input, DestInfo è un puntatore a una matrice di strutture 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 |
|---|---|
|
Il valore a cui punta NumRoutes è maggiore del numero massimo di route consentite a un client. Controllare RTM_REGN_PROFILE per il numero massimo di route che il client può recuperare con una chiamata. |
Commenti
Chiamare ripetutamente questa funzione per recuperare tutte le route.
Non sono presenti più route da enumerare quando gestione tabelle di routing restituisce zero in NumRoutes.
Per il codice di esempio che usa questa funzione, vedere Usare un elenco di route Client-Specific.
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 |