Fonction RtmCreateNextHopEnum (rtmv2.h)

Article
08/25/2023

RtmCreateNextHopEnum énumère les tronçons suivants dans la liste des tronçons suivants.

Syntaxe

DWORD RtmCreateNextHopEnum(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  RTM_ENUM_FLAGS    EnumFlags,
  [in]  PRTM_NET_ADDRESS  NetAddress,
  [out] PRTM_ENUM_HANDLE  RtmEnumHandle
);

Paramètres

[in] RtmRegHandle

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

[in] EnumFlags

Spécifie les tronçons suivants à inclure dans l’énumération. Les indicateurs suivants sont utilisés.

Constant	Signification
RTM_ENUM_NEXT	Énumérez les tronçons suivants en commençant à la longueur d’adresse/de masque spécifiée (par exemple, 10/8). L’énumération se poursuit jusqu’à la fin de la liste de tronçons suivante.
RTM_ENUM_RANGE	Énumérez les tronçons suivants dans la plage spécifiée spécifiée par la longueur d’adresse/masque (par exemple, 10/8).
RTM_ENUM_START	Énumérez les tronçons suivants à partir de 0/0. Spécifiez NULL pour NetAddress.

[in] NetAddress

Pointeur vers une structure RTM_NET_ADDRESS qui contient l’adresse de départ de l’énumération. Spécifiez NULL si EnumFlags contient RTM_ENUM_START.

[out] RtmEnumHandle

En entrée, RtmEnumHandle est un pointeur vers NULL.

Lors de la sortie, RtmEnumHandle reçoit un pointeur vers un handle vers l’énumération. Utilisez ce handle dans tous les appels suivants à RtmGetEnumNextHops, RtmReleaseNextHops et RtmDeleteEnumHandle.

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	Un paramètre contient des informations incorrectes.
ERROR_NOT_ENOUGH_MEMORY	La mémoire est insuffisante pour effectuer cette opération.

Notes

Si EnumFlags contient RTM_ENUM_RANGE, utilisez NetAddress pour spécifier la plage de la table de routage à énumérer. Par exemple, si un client définit NetAddress sur 10/8, les tronçons suivants de la plage 10.0.0.0/8 à 10.255.255.255/32 sont retournés.

Lorsque le handle d’énumération n’est plus requis, relâchez-le en appelant RtmDeleteEnumHandle.

Spécifications


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

Partager via