Funzione RtmGetEnumRoutes (rtmv2.h)
La funzione RtmGetEnumRoutes recupera il set successivo di route nell'enumerazione specificata.
Sintassi
DWORD RtmGetEnumRoutes(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] RTM_ENUM_HANDLE EnumHandle,
[in, out] PUINT NumRoutes,
[out] PRTM_ROUTE_HANDLE RouteHandles
);
Parametri
[in] RtmRegHandle
Handle per il client ottenuto da una chiamata precedente a RtmRegisterEntity.
[in] EnumHandle
Handle per l'enumerazione di route.
[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 RouteHandles è un puntatore a una struttura RTM_ROUTE_INFO .
Nell'output RouteHandles riceve una matrice di handle per le route.
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 |
|---|---|
|
Il valore a cui punta NumRoutes è maggiore del numero massimo di route che un client può recuperare con una chiamata. Controllare RTM_REGN_PROFILE il numero massimo di route che il client può recuperare con una sola chiamata. |
|
Non sono disponibili altre route da enumerare. |
|
Memoria insufficiente per completare questa operazione. |
Commenti
Quando le route non sono più necessarie, rilasciarle chiamando RtmReleaseRoutes.
Per il codice di esempio che usa questa funzione, vedere Enumerare tutte le route.
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 |