RtmGetNextHopPointer-Funktion (rtmv2.h)

Artikel
03/04/2024

Die RtmGetNextHopPointer-Funktion ruft einen direkten Zeiger auf den angegebenen nächsten Hop ab. Der Zeiger ermöglicht dem Besitzer des nächsten Hops direkten Lesezugriff auf die RTM_NEXTHOP_INFO-Struktur des Routingtabellen-Managers.

Syntax

DWORD RtmGetNextHopPointer(
  [in]  RTM_ENTITY_HANDLE  RtmRegHandle,
  [in]  RTM_NEXTHOP_HANDLE NextHopHandle,
  [out] PRTM_NEXTHOP_INFO  *NextHopPointer
);

Parameter

[in] RtmRegHandle

Handle an den Client, der von einem vorherigen Aufruf von RtmRegisterEntity abgerufen wurde.

[in] NextHopHandle

Handle bis zum nächsten Hop.

[out] NextHopPointer

Wenn der Client der Besitzer des nächsten Hops ist, erhält NextHopPointer einen Zeiger auf den nächsten Hop.

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_INVALID_HANDLE	Das Handle ist ungültig.

Hinweise

Clients sollten diesen Zeiger nur für den schreibgeschützten Zugriff verwenden.

Wenn das Handle für den nächsten Hop nicht mehr erforderlich ist, geben Sie es durch Aufrufen von RtmReleaseNextHopInfo frei.

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