RtmFindNextHop-Funktion (rtmv2.h)

Artikel
03/06/2024

Die RtmFindNextHop-Funktion findet einen bestimmten nächsten Hop in der Next-Hop-Liste eines Clients.

Syntax

DWORD RtmFindNextHop(
  [in]  RTM_ENTITY_HANDLE   RtmRegHandle,
  [in]  PRTM_NEXTHOP_INFO   NextHopInfo,
  [out] PRTM_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] NextHopInfo

Zeiger auf eine RTM_NEXTHOP_INFO Struktur, die Informationen enthält, die den nächsten zu findenden Hop identifizieren. Verwenden Sie die Member NextHopAddress und InterfaceIndex , um den nächsten zu findenden Hop zu identifizieren.

[out] NextHopHandle

Wenn ein Handle zurückgegeben werden muss: Bei der Eingabe ist NextHopPointer ein Zeiger auf NULL. Wenn der Client den nächsten Hop besitzt, empfängt NextHopPointer bei der Ausgabe einen Zeiger auf das Handle für den nächsten Hop. Andernfalls bleibt NextHopPointer unverändert.

Wenn kein Handle zurückgegeben werden muss: Bei der Eingabe ist NextHopPointerNULL.

[out] NextHopPointer

Wenn ein Zeiger zurückgegeben werden muss: Bei der Eingabe ist NextHopPointer ein Zeiger auf NULL. Wenn der Client den nächsten Hop besitzt, empfängt NextHopPointer bei der Ausgabe einen Zeiger auf den nächsten Hop. Andernfalls bleibt NextHopPointer unverändert.

Wenn kein Zeiger zurückgegeben werden muss: Bei der Eingabe ist NextHopPointerNULL.

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

NextHopPointer ist gültig, solange der Client NextHopHandle nicht freigegeben hat.

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