Funzione RtmDeleteRouteToDest (rtmv2.h)

Articolo
03/15/2023

La funzione RtmDeleteRouteToDest elimina una route dalla tabella di routing e aggiorna le informazioni sulla route migliore per la destinazione corrispondente, se la route migliore è cambiata. Se la route migliore cambia, viene generata una notifica di modifica.

Sintassi

DWORD RtmDeleteRouteToDest(
  [in]  RTM_ENTITY_HANDLE       RtmRegHandle,
  [in]  RTM_ROUTE_HANDLE        RouteHandle,
  [out] PRTM_ROUTE_CHANGE_FLAGS ChangeFlags
);

Parametri

[in] RtmRegHandle

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

[in] RouteHandle

Gestire la route da eliminare.

[out] ChangeFlags

In input ChangeFlags è un puntatore a RTM_ROUTE_CHANGE_FLAGS tipo di dati.

Nell'output ChangeFlags riceve RTM_ROUTE_CHANGE_BEST flag se la route migliore è stata modificata.

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 questa route.
ERROR_INVALID_HANDLE	Handle non valido.
ERROR_NOT_FOUND	Non è stata trovata la route specificata.

Commenti

RouteHandle non deve essere successivamente rilasciato da un client se il client ha già chiamato RtmDeleteRouteToDest usando tale handle. La funzione RtmDeleteRouteToDest elimina la route e rilascia l'handle.

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

RtmUpdateAndUnlockRoute

Condividi tramite