RtmLockNextHop-Funktion (rtmv2.h)

Artikel
03/04/2024

Die RtmLockNextHop-Funktion sperrt oder entsperrt einen nächsten Hop. Diese Funktion sollte vom Besitzer des nächsten Hops aufgerufen werden, um den nächsten Hop zu sperren, bevor Änderungen am nächsten Hop vorgenommen werden. Ein Zeiger auf den nächsten Hop wird zurückgegeben.

Syntax

DWORD RtmLockNextHop(
  [in]  RTM_ENTITY_HANDLE  RtmRegHandle,
  [in]  RTM_NEXTHOP_HANDLE NextHopHandle,
  [in]  BOOL               Exclusive,
  [in]  BOOL               LockNextHop,
  [out] PRTM_NEXTHOP_INFO  *NextHopPointer
);

Parameter

[in] RtmRegHandle

Handle mit dem Client, der von einem vorherigen Aufruf von RtmRegisterEntity abgerufen wurde.

[in] NextHopHandle

Behandeln Sie den nächsten Hop, um zu sperren oder zu entsperren.

[in] Exclusive

Gibt an, ob der nächste Hop in einem exklusiven (TRUE) oder freigegebenen Modus (FALSE) gesperrt oder entsperrt werden soll.

[in] LockNextHop

Gibt an, ob der nächste Hop gesperrt oder entsperrt werden soll. Geben Sie TRUE an, um den nächsten Hop zu sperren. Geben Sie FALSE an, um sie zu entsperren.

[out] NextHopPointer

Bei der Eingabe ist NextHopPointer ein Zeiger auf NULL.

Wenn der Client den nächsten Hop besitzt, erhält NextHopPointer bei der Ausgabe einen Zeiger auf den nächsten Hop. Andernfalls bleibt NextHopPointer unverändert.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Wert	Bedeutung
ERROR_ACCESS_DENIED	Der aufrufende Client besitzt diesen nächsten Hop nicht.
ERROR_NOT_FOUND	Der angegebene nächste Hop wurde nicht gefunden.

Hinweise

Clients können die Elemente NextHopAddress und InterfaceIndex der RTM_NEXTHOP_INFO Struktur nicht ändern. Diese Werte werden verwendet, um einen nächsten Hop eindeutig zu identifizieren.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	rtmv2.h
Bibliothek	Rtm.lib
DLL	Rtm.dll

Weitere Informationen

Freigeben über