Функция RtmGetRoutePointer (rtmv2.h)

Функция RtmGetRoutePointer получает прямой указатель на маршрут, который предоставляет владельцу маршрута доступ на чтение.

Синтаксис

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

[in] RtmRegHandle

Дескриптор клиента, полученного при предыдущем вызове RtmRegisterEntity.

[in] RouteHandle

Дескриптор маршрута.

[out] RoutePointer

Во входных данных RoutePointer является указателем на NULL.

В выходных данных RoutePointer получает указатель на маршрут.

Если функция выполнена успешно, возвращаемое значение будет NO_ERROR.

Если функция завершается сбоем, возвращается один из следующих кодов ошибок.

Значение	Значение
ERROR_ACCESS_DENIED	Вызывающий клиент не владеет этим маршрутом.
ERROR_INVALID_HANDLE	Дескриптор недействителен.

Требование	Значение
Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	rtmv2.h
Библиотека	Rtm.lib
DLL	Rtm.dll