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