Partager via


Fonction RtmDeleteNextHop (rtmv2.h)

La fonction RtmDeleteNextHop supprime un tronçon suivant de la liste des tronçons suivants.

Syntaxe

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

Paramètres

[in] RtmRegHandle

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

[in] NextHopHandle

Gérez jusqu’au tronçon suivant à supprimer. Ce paramètre est facultatif et peut être défini sur NULL ; si elle a la valeur NULL, les valeurs dans NextHopInfo sont utilisées pour identifier le tronçon suivant à supprimer.

[in] NextHopInfo

Pointeur vers une structure qui contient des informations identifiant le tronçon suivant à supprimer. Ce paramètre est facultatif et peut être défini sur NULL ; s’il a la valeur NULL, le handle dans NextHopHandle est utilisé pour identifier le tronçon suivant à supprimer.

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 ne possède pas ce tronçon suivant.
ERROR_NOT_ENOUGH_MEMORY
La mémoire est insuffisante pour effectuer cette opération.
ERROR_NOT_FOUND
Le tronçon suivant spécifié est introuvable.
 
 

Notes

Si un client spécifie un NextHopHandle, le client ne doit pas libérer le handle à l’aide de RtmReleaseNextHops.

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

RTM_NEXTHOP_INFO

RtmAddNextHop

RtmFindNextHop

RtmGetNextHopPointer