Funzione RtmFindNextHop (rtmv2.h)

Articolo
03/01/2024

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
ERROR_ACCESS_DENIED	Il client chiamante non possiede questo hop successivo.
ERROR_NOT_FOUND	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