Lire en anglais

Partager via


Fonction RtmLockNextHop (rtmv2.h)

La fonction RtmLockNextHop verrouille ou déverrouille un tronçon suivant. Cette fonction doit être appelée par le propriétaire du tronçon suivant pour verrouiller le tronçon suivant avant d’apporter des modifications au tronçon suivant. Un pointeur vers le tronçon suivant est retourné.

Syntaxe

DWORD RtmLockNextHop(
  [in]  RTM_ENTITY_HANDLE  RtmRegHandle,
  [in]  RTM_NEXTHOP_HANDLE NextHopHandle,
  [in]  BOOL               Exclusive,
  [in]  BOOL               LockNextHop,
  [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 le tronçon suivant pour verrouiller ou déverrouiller.

[in] Exclusive

Spécifie s’il faut verrouiller ou déverrouiller le tronçon suivant en mode exclusif (TRUE) ou partagé (FALSE).

[in] LockNextHop

Spécifie s’il faut verrouiller ou déverrouiller le tronçon suivant. Spécifiez TRUE pour verrouiller le tronçon suivant ; spécifiez FALSE pour le déverrouiller.

[out] NextHopPointer

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

En 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é.

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

Les clients ne peuvent pas modifier les membres NextHopAddress et InterfaceIndex de la structure RTM_NEXTHOP_INFO ; ces valeurs sont utilisées pour identifier de manière unique un tronçon suivant.

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

RTM_NEXTHOP_INFO

RtmAddNextHop

RtmDeleteNextHop

RtmFindNextHop

RtmGetNextHopPointer