Fonction RtmCreateRouteListEnum (rtmv2.h)
La fonction RtmCreateRouteListEnum crée une énumération d’itinéraires dans la liste d’itinéraires spécifiée.
Syntaxe
DWORD RtmCreateRouteListEnum(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] RTM_ROUTE_LIST_HANDLE RouteListHandle,
[out] PRTM_ENUM_HANDLE RtmEnumHandle
);
Paramètres
[in] RtmRegHandle
Gérez le client obtenu à partir d’un appel précédent à RtmRegisterEntity.
[in] RouteListHandle
Accédez à la liste d’itinéraires à énumérer obtenue à partir d’un appel précédent à RtmCreateRouteList.
[out] RtmEnumHandle
Lors de l’entrée, RtmEnumHandle est un pointeur vers NULL.
À la sortie, RtmEnumHandle reçoit un pointeur vers un handle vers l’énumération. Utilisez ce handle dans tous les appels suivants aux fonctions qui énumèrent la liste des itinéraires.
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 |
|---|---|
|
La mémoire est insuffisante pour effectuer cette opération. |
Remarques
Lorsque le handle d’énumération n’est plus nécessaire, relâchez-le en appelant RtmDeleteEnumHandle.
Pour obtenir un exemple de code utilisant cette fonction, consultez Utiliser une liste d’itinéraires 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 |