Funzione RtmFindNextHop (rtmv2.h)
La funzione RtmFindNextHop trova un hop successivo specifico nell'elenco hop successivo di un client.
Sintassi
DWORD RtmFindNextHop(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] PRTM_NEXTHOP_INFO NextHopInfo,
[out] PRTM_NEXTHOP_HANDLE NextHopHandle,
[out] PRTM_NEXTHOP_INFO *NextHopPointer
);
Parametri
[in] RtmRegHandle
Gestire il client ottenuto da una chiamata precedente a RtmRegisterEntity.
[in] NextHopInfo
Puntatore a una struttura RTM_NEXTHOP_INFO contenente informazioni che identificano l'hop successivo da trovare. Usare i membri NextHopAddress e InterfaceIndex per identificare l'hop successivo da trovare.
[out] NextHopHandle
Se deve essere restituito un handle: in input NextHopPointer è un puntatore a NULL. In output, se il client possiede l'hop successivo, NextHopPointer riceve un puntatore all'handle hop successivo; in caso contrario , NextHopPointer rimane invariato.
Se non è necessario restituire un handle: in input , NextHopPointer è NULL.
[out] NextHopPointer
Se deve essere restituito un puntatore: in input NextHopPointer è un puntatore a NULL. In output, se il client possiede l'hop successivo, NextHopPointer riceve un puntatore all'hop successivo; in caso contrario , NextHopPointer rimane invariato.
Se non è necessario restituire un puntatore: in input NextHopPointer è NULL.
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 client chiamante non possiede questo hop successivo. |
|
Impossibile trovare l'hop successivo specificato. |
Commenti
NextHopPointer è valido finché il client non ha rilasciato NextHopHandle.
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 |