Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |