RtmInsertInRouteList-Funktion (rtmv2.h)
Die RtmInsertInRouteList-Funktion fügt den angegebenen Satz von Routen in die Routenliste des Clients ein. Wenn eine Route bereits in einer anderen Liste enthalten ist, wird die Route aus der alten Liste entfernt und in die neue Liste eingefügt.
Syntax
DWORD RtmInsertInRouteList(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] RTM_ROUTE_LIST_HANDLE RouteListHandle,
[in] UINT NumRoutes,
[in] PRTM_ROUTE_HANDLE RouteHandles
);
Parameter
[in] RtmRegHandle
Handle an den Client, der von einem vorherigen Aufruf von RtmRegisterEntity abgerufen wurde.
[in] RouteListHandle
Handle für die Routenliste, der Routen hinzugefügt werden sollen. Geben Sie NULL an, um die angegebenen Routen aus den alten Listen zu entfernen.
[in] NumRoutes
Gibt die Anzahl der Routen in RouteHandles an.
[in] RouteHandles
Zeiger auf ein Array von Routenhandles, um von der alten Liste in die neue Liste zu wechseln.
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 |
|---|---|
|
Das Handle ist ungültig. |
Hinweise
Wenn die Routen nicht mehr benötigt werden, geben Sie sie durch Aufrufen von RtmReleaseRoutes 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 |