Partager via


Fonction RtmDeleteRouteToDest (rtmv2.h)

La fonction RtmDeleteRouteToDest supprime un itinéraire de la table de routage et met à jour les meilleures informations d’itinéraire pour la destination correspondante, si la meilleure route a changé. Si la meilleure route change, une notification de modification est générée.

Syntaxe

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

Paramètres

[in] RtmRegHandle

Gérez le client obtenu à partir d’un appel précédent à RtmRegisterEntity.

[in] RouteHandle

Gérez l’itinéraire à supprimer.

[out] ChangeFlags

En entrée, ChangeFlags est un pointeur vers RTM_ROUTE_CHANGE_FLAGS type de données.

Lors de la sortie, ChangeFlags reçoit RTM_ROUTE_CHANGE_BEST indicateur si la meilleure route a été modifiée.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Valeur Signification
ERROR_ACCESS_DENIED
Le client appelant n’est pas propriétaire de cet itinéraire.
ERROR_INVALID_HANDLE
Le handle n'est pas valide.
ERROR_NOT_FOUND
L’itinéraire spécifié est introuvable.
 
 

Notes

RouteHandle ne doit pas être libéré par la suite par un client si le client a déjà appelé RtmDeleteRouteToDest à l’aide de ce handle. La fonction RtmDeleteRouteToDest supprime l’itinéraire et libère le handle.

Spécifications

   
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête rtmv2.h
Bibliothèque Rtm.lib
DLL Rtm.dll

Voir aussi

RtmAddRouteToDest

RtmGetRoutePointer

RtmHoldDestination

RtmLockRoute

RtmUpdateAndUnlockRoute