RtmCreateRouteListEnum-Funktion (rtmv2.h)
Die RtmCreateRouteListEnum-Funktion erstellt eine Enumeration von Routen in der angegebenen Routenliste.
Syntax
DWORD RtmCreateRouteListEnum(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] RTM_ROUTE_LIST_HANDLE RouteListHandle,
[out] PRTM_ENUM_HANDLE RtmEnumHandle
);
Parameter
[in] RtmRegHandle
Handle an den Client, der von einem vorherigen Aufruf von RtmRegisterEntity abgerufen wurde.
[in] RouteListHandle
Handle für die Routenliste, um aufzuzählen, die aus einem vorherigen Aufruf von RtmCreateRouteList abgerufen wurde.
[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 Funktionen, die die Liste der Routen auflisten.
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 |
|---|---|
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um diesen Vorgang abzuschließen. |
Hinweise
Wenn das Enumerationshandle nicht mehr erforderlich ist, geben Sie es durch Aufrufen von RtmDeleteEnumHandle frei.
Beispielcode mit dieser Funktion finden Sie unter Verwenden einer Client-Specific Routenliste.
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 |