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
ERROR_INVALID_PARAMETER	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.
ERROR_NO_MORE_ITEMS	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

Voir aussi

RtmCreateNextHopEnum

RtmDeleteEnumHandle

RtmReleaseNextHops