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
FEHLER _ UNGÜLTIGES _ HANDLE
Der EnumerationHandle-Parameter ist ungültig.
FEHLER: _ _ KEINE ROUTEN _ MEHR
Die -Enumeration enthält keine Routen mehr.
FEHLER: _ _ KEINE _ SYSTEMRESSOURCEN
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
Rtm.h
Bibliothek
Rtm.lib
DLL
Rtm.dll

Siehe auch

Routing Table Manager Version 1 Reference

Routingtabellen-Manager- Version 1-Funktionen

_RTM-IP-ROUTE _

_RTM-IPX-ROUTE _

RtmCloseEnumerationHandle

RtmCreateEnumerationHandle