Fonction RtmGetNextHopPointer (rtmv2.h)

Article
03/01/2024

La fonction RtmGetNextHopPointer obtient un pointeur direct vers le tronçon suivant spécifié. Le pointeur permet au propriétaire du tronçon suivant d’accéder directement en lecture à la structure RTM_NEXTHOP_INFO du gestionnaire de table de routage.

Syntaxe

DWORD RtmGetNextHopPointer(
  [in]  RTM_ENTITY_HANDLE  RtmRegHandle,
  [in]  RTM_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] NextHopHandle

Gérez jusqu’au tronçon suivant.

[out] NextHopPointer

Si le client est le propriétaire du tronçon suivant, NextHopPointer reçoit un pointeur vers le tronçon suivant.

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_INVALID_HANDLE	Le handle n'est pas valide.

Remarques

Les clients doivent uniquement utiliser ce pointeur pour l’accès en lecture seule.

Lorsque le handle de tronçon suivant n’est plus nécessaire, relâchez-le en appelant RtmReleaseNextHopInfo.

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

Partager via