RtmGetEnumNextHops-Funktion (rtmv2.h)

Die RtmGetEnumNextHops-Funktion ruft den nächsten Satz der nächsten Hops in der angegebenen Enumeration ab.

Syntax

DWORD RtmGetEnumNextHops(
  [in]      RTM_ENTITY_HANDLE   RtmRegHandle,
  [in]      RTM_ENUM_HANDLE     EnumHandle,
  [in, out] PUINT               NumNextHops,
  [out]     PRTM_NEXTHOP_HANDLE NextHopHandles
);

Parameter

[in] RtmRegHandle

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

[in] EnumHandle

Handle mit der Next-Hop-Enumeration.

[in, out] NumNextHops

NumNextHops ist bei der Eingabe ein Zeiger auf einen UINT-Wert, der die maximale Anzahl der nächsten Hops angibt, die von NextHopHandles empfangen werden können.

Bei der Ausgabe empfängt NumNextHops die tatsächliche Anzahl der nächsten Hops, die von NextHopHandles empfangen werden.

[out] NextHopHandles

In der Eingabe zeigt NextHopHanders auf eine RTM_NEXTHOP_INFO-Struktur .

Bei der Ausgabe empfängt NextHopHandles ein Array von Handles zu den nächsten Hops.

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_INVALID_PARAMETER	Der Wert, auf den numRoutes verweist, ist größer als die maximale Anzahl von Routen, die ein Client mit einem Aufruf abrufen darf. Überprüfen Sie RTM_REGN_PROFILE auf die maximale Anzahl der nächsten Hops, die der Client mit einem Aufruf abrufen darf.
ERROR_NO_MORE_ITEMS	Es gibt keine weiteren Hops mehr, die aufgelistet werden müssen.

 

 

Hinweise

Wenn die nächsten Hops nicht mehr erforderlich sind, lassen Sie sie los, indem Sie RtmReleaseNextHops aufrufen.

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

RtmCreateNextHopEnum

RtmDeleteEnumHandle

RtmReleaseNextHops