RtmEnumerateGetNextRoute-Funktion
[Diese API wurde durch die RoutingTabellen-Manager-API Version 2 ersetzt und ist über Windows Server 2003 hinaus nicht mehr verfügbar. Anwendungen sollten die Routingtabellen-Manager-API Version 2 verwenden.]
Die RtmEnumerateGetNextRoute-Funktion gibt den Next-Route-Eintrag in der -Enumeration zurück, der durch einen Aufruf von RtmCreateEnumerationHandle gestartet wurde.
Syntax
DWORD RtmEnumerateGetNextRoute(
_In_ HANDLE EnumerationHandle,
_Out_ PVOID Route
);
Parameter
-
EnumerationHandle [ In]
-
Handle, das die Enumeration identifiziert und ihren Bereich angibt. Rufen Sie dieses Handle ab, indem Sie RtmCreateEnumerationHandle aufrufen.
-
Route [ out]
-
Zeiger auf eine protokollfamilienspezifische Routenstruktur ( RTM _ IP _ ROUTE oder RTM _ IPX _ ROUTE). Diese Struktur erhält die nächste Route in der -Enumeration.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert NO _ ERROR.
Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.
| Wert | BESCHREIBUNG |
|---|---|
|
Der EnumerationHandle-Parameter ist ungültig. |
|
Die -Enumeration enthält keine Routen mehr. |
|
Es sind nicht genügend Ressourcen zum Durchführen des Vorgangs verfügbar. |
Hinweise
Obwohl Routen nicht in einer bestimmten Reihenfolge zurückgegeben werden, wird jede Route in der -Enumeration nur einmal zurückgegeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Nicht unterstützt |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Ende des Supports (Server) |
Windows Server 2003 |
| Header |
|
| Bibliothek |
|
| DLL |
|