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 |
|---|---|
|
Aucun itinéraire n’a les critères spécifiés. |
|
Le paramètre ClientHandle n’est pas 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. |
|
Les ressources sont insuffisantes pour effectuer l’opération. |
|
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 |
|
| Bibliothèque |
|
| DLL |
|