Condividi tramite


Funzione RtmDeleteNextHop (rtmv2.h)

La funzione RtmDeleteNextHop elimina un hop successivo dall'elenco hop successivo.

Sintassi

DWORD RtmDeleteNextHop(
  [in] RTM_ENTITY_HANDLE  RtmRegHandle,
  [in] RTM_NEXTHOP_HANDLE NextHopHandle,
  [in] PRTM_NEXTHOP_INFO  NextHopInfo
);

Parametri

[in] RtmRegHandle

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

[in] NextHopHandle

Gestire l'hop successivo da eliminare. Questo parametro è facoltativo e può essere impostato su NULL; se è NULL, i valori in NextHopInfo vengono usati per identificare l'hop successivo da eliminare.

[in] NextHopInfo

Puntatore a una struttura che contiene informazioni che identificano l'hop successivo da eliminare. Questo parametro è facoltativo e può essere impostato su NULL; se è NULL, l'handle in NextHopHandle viene usato per identificare l'hop successivo da eliminare.

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_ENOUGH_MEMORY
Memoria insufficiente per completare questa operazione.
ERROR_NOT_FOUND
Impossibile trovare l'hop successivo specificato.
 
 

Commenti

Se un client specifica NextHopHandle, il client non deve successivamente rilasciare l'handle usando RtmReleaseNextHops.

Requisiti

   
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

Vedi anche

RTM_NEXTHOP_INFO

RtmAddNextHop

RtmFindNextHop

RtmGetNextHopPointer