Fonction RtmGetEnumNextHops (rtmv2.h)
La fonction RtmGetEnumNextHops récupère l’ensemble suivant de tronçons suivants dans l’énumération spécifiée.
Syntaxe
DWORD RtmGetEnumNextHops(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] RTM_ENUM_HANDLE EnumHandle,
[in, out] PUINT NumNextHops,
[out] PRTM_NEXTHOP_HANDLE NextHopHandles
);
Paramètres
[in] RtmRegHandle
Gérez le client obtenu à partir d’un appel précédent à RtmRegisterEntity.
[in] EnumHandle
Gérez l’énumération du tronçon suivant.
[in, out] NumNextHops
En entrée, NumNextHops est un pointeur vers une valeur UINT spécifiant le nombre maximal de tronçons suivants pouvant être reçus par NextHopHandles.
À la sortie, NumNextHops reçoit le nombre réel de tronçons suivants reçus par NextHopHandles.
[out] NextHopHandles
En entrée, NextHopHandles pointe vers une structure RTM_NEXTHOP_INFO .
Lors de la sortie, NextHopHandles reçoit un tableau de handles aux tronçons suivants.
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 valeur pointée par NumRoutes est supérieure au nombre maximal d’itinéraires qu’un client est autorisé à récupérer avec un seul appel. Vérifiez RTM_REGN_PROFILE le nombre maximal de tronçons suivants que le client est autorisé à récupérer avec un seul appel. |
|
Il n’y a plus de tronçons suivants à énumérer. |
Remarques
Lorsque les tronçons suivants ne sont plus nécessaires, relâchez-les en appelant RtmReleaseNextHops.
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 |