Fonction RtmInsertInRouteList (rtmv2.h)

Article
03/04/2024

La fonction RtmInsertInRouteList insère l’ensemble d’itinéraires spécifié dans la liste des itinéraires du client. Si un itinéraire figure déjà dans une autre liste, celui-ci est supprimé de l’ancienne liste et inséré dans la nouvelle.

Syntaxe

DWORD RtmInsertInRouteList(
  [in] RTM_ENTITY_HANDLE     RtmRegHandle,
  [in] RTM_ROUTE_LIST_HANDLE RouteListHandle,
  [in] UINT                  NumRoutes,
  [in] PRTM_ROUTE_HANDLE     RouteHandles
);

Paramètres

[in] RtmRegHandle

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

[in] RouteListHandle

Gérez la liste de routes à laquelle ajouter des itinéraires. Spécifiez NULL pour supprimer les itinéraires spécifiés de leurs anciennes listes.

[in] NumRoutes

Spécifie le nombre d’itinéraires dans RouteHandles.

[in] RouteHandles

Pointeur vers un tableau de handles de routage pour passer de l’ancienne liste à la nouvelle liste.

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_INVALID_HANDLE	Le handle n'est pas valide.

Remarques

Lorsque les itinéraires ne sont plus nécessaires, relâchez-les en appelant RtmReleaseRoutes.

Pour obtenir un exemple de code utilisant cette fonction, consultez Utiliser une liste de routes Client-Specific.

Configuration requise

Condition requise	Valeur
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

RtmCreateRouteList

RtmDeleteRouteList

Partager via