RtmGetRouteInfo-Funktion (rtmv2.h)
Die RtmGetRouteInfo-Funktion gibt Informationen für die angegebene Route zurück.
Syntax
DWORD RtmGetRouteInfo(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] RTM_ROUTE_HANDLE RouteHandle,
[out] PRTM_ROUTE_INFO RouteInfo,
[out] PRTM_NET_ADDRESS DestAddress
);
Parameter
[in] RtmRegHandle
Handle an den Client, der von einem vorherigen Aufruf von RtmRegisterEntity abgerufen wurde.
[in] RouteHandle
Handle für die zu findende Route.
[out] RouteInfo
Wenn ein Zeiger zurückgegeben werden muss: Bei der Eingabe ist RouteInfo ein Zeiger auf NULL. Bei der Ausgabe empfängt RouteInfo einen Zeiger auf die Route. Andernfalls bleibt RouteInfo unverändert.
Wenn kein Zeiger zurückgegeben werden muss: Bei der Eingabe ist RouteInfoNULL.
[out] DestAddress
Wenn ein Zeiger zurückgegeben werden muss: Bei der Eingabe ist DestAddress ein Zeiger auf NULL. Bei der Ausgabe empfängt DestAddress einen Zeiger auf die RTM_NET_ADDRESS Struktur des Ziels. Andernfalls bleibt DestAddress unverändert.
Wenn kein Zeiger zurückgegeben werden muss: Bei der Eingabe ist DestAddressNULL.
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 RtmReleaseRouteInfo frei.
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 |