RtmCreateNextHopEnum-Funktion (rtmv2.h)

Artikel
08/25/2023

RtmCreateNextHopEnum listet die nächsten Hops in der Next-Hop-Liste auf.

Syntax

DWORD RtmCreateNextHopEnum(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  RTM_ENUM_FLAGS    EnumFlags,
  [in]  PRTM_NET_ADDRESS  NetAddress,
  [out] PRTM_ENUM_HANDLE  RtmEnumHandle
);

Parameter

[in] RtmRegHandle

Handle mit dem Client, der von einem vorherigen Aufruf von RtmRegisterEntity abgerufen wurde.

[in] EnumFlags

Gibt an, welche nächsten Hops in die Enumeration eingeschlossen werden sollen. Die folgenden Flags werden verwendet.

Konstante	Bedeutung
RTM_ENUM_NEXT	Führen Sie nächste Hops auf, die mit der angegebenen Adress-/Maskenlänge beginnen (z. B. 10/8). Die Enumeration wird bis zum Ende der nächsten Hopliste fortgesetzt.
RTM_ENUM_RANGE	Führen Sie die nächsten Hops in dem angegebenen Bereich auf, der durch die Adress-/Maskenlänge angegeben wird (z. B. 10/8).
RTM_ENUM_START	Führen Sie die nächsten Hops ab 0/0 auf. Geben Sie NULL für NetAddress an.

[in] NetAddress

Zeiger auf eine RTM_NET_ADDRESS-Struktur , die die Startadresse der Enumeration enthält. Geben Sie NULL an, wenn EnumFlags RTM_ENUM_START enthält.

[out] RtmEnumHandle

Bei der Eingabe ist RtmEnumHandle ein Zeiger auf NULL.

Bei der Ausgabe empfängt RtmEnumHandle einen Zeiger auf ein Handle auf die Enumeration. Verwenden Sie dieses Handle in allen nachfolgenden Aufrufen von RtmGetEnumNextHops, RtmReleaseNextHops und RtmDeleteEnumHandle.

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
ERROR_INVALID_PARAMETER	Ein Parameter enthält falsche Informationen.
ERROR_NOT_ENOUGH_MEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um diesen Vorgang abzuschließen.

Hinweise

Wenn EnumFlags RTM_ENUM_RANGE enthält, verwenden Sie NetAddress , um den Bereich der Routingtabelle anzugeben, die aufgelistet werden soll. Wenn beispielsweise ein Client NetAddress auf 10/8 festlegt, werden die nächsten Hops im Bereich 10.0.0.0/8 bis 10.255.255.255/32 zurückgegeben.

Wenn das Enumerationshandle nicht mehr erforderlich ist, geben Sie es frei, indem Sie RtmDeleteEnumHandle aufrufen.

Anforderungen


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

Weitere Informationen

Freigeben über