RtmGetRoutePointer-Funktion (rtmv2.h)

Die RtmGetRoutePointer-Funktion ruft einen direkten Zeiger auf eine Route ab, die dem Besitzer des Routenlesezugriffs ermöglicht.

Syntax

DWORD RtmGetRoutePointer(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  RTM_ROUTE_HANDLE  RouteHandle,
  [out] PRTM_ROUTE_INFO   *RoutePointer
);

[in] RtmRegHandle

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

[in] RouteHandle

Handle mit der Route.

[out] RoutePointer

Bei der Eingabe ist RoutePointer ein Zeiger auf NULL.

Bei der Ausgabe empfängt RoutePointer einen Zeiger auf die Route.

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_ACCESS_DENIED	Der aufrufende Client besitzt diese Route nicht.
ERROR_INVALID_HANDLE	Das Handle ist ungültig.

Der zurückgegebene Zeiger verweist auf den öffentlichen Teil der Route.

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