RtmBlockDeleteRoutes fonction)

[cette api a été remplacée par l’api du gestionnaire de Table de routage Version 2 et ne sera pas disponible au-delà de Windows Server 2003. Les applications doivent utiliser l’API du gestionnaire de table de routage version 2.]

La fonction RtmBlockDeleteRoutes supprime tous les itinéraires dans le sous-ensemble spécifié d’itinéraires dans la table.

Syntaxe

HANDLE RtmBlockDeleteRoutes(
  _In_ HANDLE ClientHandle,
  _In_ DWORD  EnumerationFlags,
  _In_ PVOID  CriteriaRoute
);

Paramètres

ClientHandle [ dans]

Handle qui identifie le client et, par conséquent, le protocole de routage des itinéraires à supprimer.

EnumerationFlags [ dans]

Spécifie les itinéraires qui doivent être énumérés. Ce paramètre limite l’ensemble des itinéraires supprimés à un sous-ensemble défini par les indicateurs suivants et les valeurs des membres correspondants de la structure vers laquelle pointe le paramètre CriteriaRoute . Les indicateurs sont les mêmes que ceux utilisés dans RtmCreateEnumerationHandle , à ceci près que la version RTM _ _ _ des meilleurs itinéraires est redondante pour RtmBlockDeleteRoutes. La meilleure désignation de route est ajustée en fonction de la suppression des itinéraires. par conséquent, la fonction supprime tous les itinéraires dans le sous-ensemble.

CriteriaRoute [ dans]

Pointeur vers une structure de route spécifique à la famille de protocoles ( _ _ itinéraire IP RTM ou _ _ itinéraire IPX RTM). Les valeurs de membre de cette structure correspondent aux indicateurs spécifiés par le paramètre EnumerationFlags .

Valeur de retour

Si la fonction est réussie, la valeur de retour n’est pas une _ erreur.

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

Valeur Description
ERREUR _ aucun _ itinéraire
Aucun itinéraire n’a les critères spécifiés.
HANDLE d’erreur _ non valide _
Le paramètre ClientHandle n’est pas valide.
paramètre d’erreur _ non valide _
Un ou plusieurs des paramètres d’entrée ne sont pas valides, par exemple, les indicateurs d’énumération ne sont pas valides.
ERREUR _ aucune _ _ ressource système
Les ressources sont insuffisantes pour effectuer l’opération.
ERREUR _ de _ mémoire insuffisante _
La mémoire est insuffisante pour effectuer l’opération.

Notes

La fonction génère des messages de notification appropriés à tous les clients inscrits, y compris l’appelant.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Aucun pris en charge
Serveur minimal pris en charge
Windows 2000 Server - [Applications de bureau uniquement]
Fin de la prise en charge des serveurs
Windows Server 2003
En-tête
RTM. h
Bibliothèque
RTM. lib
DLL
Rtm.dll

Voir aussi

Référence de la version 1 du gestionnaire de tables de routage

Fonctions de la version 1 du gestionnaire de table de routage

RtmCreateEnumerationHandle

RtmRegisterClient