Fonction RtmFindNextHop (rtmv2.h)

Article
03/04/2024

La fonction RtmFindNextHop recherche un tronçon suivant spécifique dans la liste des tronçons suivants d’un client.

Syntaxe

DWORD RtmFindNextHop(
  [in]  RTM_ENTITY_HANDLE   RtmRegHandle,
  [in]  PRTM_NEXTHOP_INFO   NextHopInfo,
  [out] PRTM_NEXTHOP_HANDLE NextHopHandle,
  [out] PRTM_NEXTHOP_INFO   *NextHopPointer
);

Paramètres

[in] RtmRegHandle

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

[in] NextHopInfo

Pointeur vers une structure de RTM_NEXTHOP_INFO qui contient des informations identifiant le tronçon suivant à rechercher. Utilisez les membres NextHopAddress et InterfaceIndex pour identifier le tronçon suivant à rechercher.

[out] NextHopHandle

Si un handle doit être retourné : Lors de l’entrée, NextHopPointer est un pointeur vers NULL. Lors de la sortie, si le client possède le tronçon suivant, NextHopPointer reçoit un pointeur vers le handle de tronçon suivant ; sinon, NextHopPointer reste inchangé.

Si un handle n’a pas besoin d’être retourné : Lors de l’entrée, NextHopPointer a la valeur NULL.

[out] NextHopPointer

Si un pointeur doit être retourné : Lors de l’entrée, NextHopPointer est un pointeur vers NULL. À la sortie, si le client est propriétaire du tronçon suivant, NextHopPointer reçoit un pointeur vers le tronçon suivant ; sinon, NextHopPointer reste inchangé.

Si un pointeur n’a pas besoin d’être retourné : Lors de l’entrée, NextHopPointer a la valeur NULL.

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_ACCESS_DENIED	Le client appelant ne possède pas ce tronçon suivant.
ERROR_NOT_FOUND	Le tronçon suivant spécifié est introuvable.

Remarques

NextHopPointer est valide tant que le client n’a pas libéré NextHopHandle.

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