Funzione RtmGetNextHopPointer (rtmv2.h)

Articolo
03/05/2024

La funzione RtmGetNextHopPointer ottiene un puntatore diretto all'hop successivo specificato. Il puntatore consente al proprietario dell'hop successivo l'accesso diretto in lettura alla struttura di RTM_NEXTHOP_INFO del gestore tabelle di routing.

Sintassi

DWORD RtmGetNextHopPointer(
  [in]  RTM_ENTITY_HANDLE  RtmRegHandle,
  [in]  RTM_NEXTHOP_HANDLE NextHopHandle,
  [out] PRTM_NEXTHOP_INFO  *NextHopPointer
);

Parametri

[in] RtmRegHandle

Handle per il client ottenuto da una chiamata precedente a RtmRegisterEntity.

[in] NextHopHandle

Handle per l'hop successivo.

[out] NextHopPointer

Se il client è il proprietario dell'hop successivo, NextHopPointer riceve un puntatore all'hop successivo.

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

Commenti

I client devono usare questo puntatore solo per l'accesso in sola lettura.

Quando l'handle hop successivo non è più necessario, rilasciarlo chiamando RtmReleaseNextHopInfo.

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