Funzione RtmGetEnumNextHops (rtmv2.h)
La funzione RtmGetEnumNextHops recupera il set successivo di hop successivi nell'enumerazione specificata.
Sintassi
DWORD RtmGetEnumNextHops(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] RTM_ENUM_HANDLE EnumHandle,
[in, out] PUINT NumNextHops,
[out] PRTM_NEXTHOP_HANDLE NextHopHandles
);
Parametri
[in] RtmRegHandle
Gestire il client ottenuto da una chiamata precedente a RtmRegisterEntity.
[in] EnumHandle
Gestire l'enumerazione hop successivo.
[in, out] NumNextHops
In input NumNextHops è un puntatore a un valore UINT che specifica il numero massimo di hop successivi che possono essere ricevuti da NextHopHandles.
Nell'output NumNextHops riceve il numero effettivo di hop successivi ricevuti da NextHopHandles.
[out] NextHopHandles
In input , i puntatori NextHopHandles a una struttura RTM_NEXTHOP_INFO .
Nell'output , NextHopHandles riceve una matrice di handle per i hop successivi.
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 hop successivi che il client può recuperare con una chiamata. |
|
Non sono presenti più hop successivi da enumerare. |
Commenti
Quando gli hop successivi non sono più necessari, rilasciarli chiamando RtmReleaseNextHops.
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 |