Funzione RtmLockNextHop (rtmv2.h)

Articolo
03/15/2023

La funzione RtmLockNextHop blocca o sblocca un hop successivo. Questa funzione deve essere chiamata dal proprietario dell'hop successivo per bloccare l'hop successivo prima di apportare modifiche all'hop successivo. Viene restituito un puntatore all'hop successivo.

Sintassi

DWORD RtmLockNextHop(
  [in]  RTM_ENTITY_HANDLE  RtmRegHandle,
  [in]  RTM_NEXTHOP_HANDLE NextHopHandle,
  [in]  BOOL               Exclusive,
  [in]  BOOL               LockNextHop,
  [out] PRTM_NEXTHOP_INFO  *NextHopPointer
);

Parametri

[in] RtmRegHandle

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

[in] NextHopHandle

Gestire l'hop successivo per bloccare o sbloccare.

[in] Exclusive

Specifica se bloccare o sbloccare l'hop successivo in modalità esclusiva (TRUE) o condivisa (FALSE).

[in] LockNextHop

Specifica se bloccare o sbloccare l'hop successivo. Specificare TRUE per bloccare l'hop successivo; specificare FALSE per sbloccarlo.

[out] NextHopPointer

In input , NextHopPointer è un puntatore a NULL.

Nell'output, se il client possiede l'hop successivo, NextHopPointer riceve un puntatore all'hop successivo; in caso contrario , NextHopPointer rimane invariato.

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_NOT_FOUND	Impossibile trovare l'hop successivo specificato.

Commenti

I client non possono modificare i membri NextHopAddress e InterfaceIndex della struttura RTM_NEXTHOP_INFO ; questi valori vengono usati per identificare in modo univoco un hop successivo.

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