Freigeben über


RtmEnumerateGetNextRoute-Funktion

[Diese API wurde von der Routing Table Manager Version 2-API abgelöst und ist über Windows Server 2003 hinaus nicht verfügbar. Anwendungen sollten die Api für Routingtabellen-Manager Version 2 verwenden.]

Die RtmEnumerateGetNextRoute-Funktion gibt den Eintrag next-route in der Enumeration zurück, die 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 deren 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 empfängt die nächste Route in der Enumeration.

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 BESCHREIBUNG
ERROR_INVALID_HANDLE
Der EnumerationHandle-Parameter ist ungültig.
ERROR_NO_MORE_ROUTES
Die Enumeration enthält keine Routen mehr.
ERROR_NO_SYSTEM_RESOURCES
Es gibt nicht genügend Ressourcen, um den Vorgang auszuführen.

Bemerkungen

Obwohl Routen in keiner 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

Referenz zu Routingtabellen-Manager, Version 1

Routingtabellen-Manager- Version 1-Funktionen

RTM_IP_ROUTE

RTM_IPX_ROUTE

RtmCloseEnumerationHandle

RtmCreateEnumerationHandle